Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the FiinGroup Standard API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffiingroup.vn%2Ffiingroup" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffiingroup.vn%2Ffiingroup" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with FiinGroup Standard API.
Search for Vietnamese companies by name or identifier
Retrieve company profiles and VSIC industry classifications
Look up shareholders, executive positions, and entity relationships
Pull financial statements along with financial ratios and key ratios
Read performance scores and corporate risk scores for a company
GET STARTED
Monitor tracked companies for changes to their data
Patterns agents use FiinGroup Standard API for, with concrete tasks.
★ Agent-Driven Counterparty Checks
An AI agent connected through Jentic can run due diligence on a Vietnamese counterparty without a developer wiring FiinGroup's auth. The agent searches for the company, reads its profile and shareholders, pulls its financial statements and risk score, and returns a summary. Jentic injects the bearer token at call time so the credential never reaches the agent.
Search for a company by name, read its profile and shareholders, then pull its latest financial statements and corporate risk score
Financial Statement Retrieval
Analysts building models on Vietnamese firms can pull structured financials rather than scraping filings. The agent retrieves a company's financial statements and the derived financial ratios and key ratios, ready to load into a spreadsheet or model. This keeps a research pipeline sourced from a single structured feed.
Retrieve a company's financial statements, then fetch its financial ratios and key ratios for the same period
Ownership and Relationship Mapping
Teams investigating corporate structures can map who owns and is connected to a company. The agent reads shareholders, executive positions, and entity relationships to build a graph of the company's connections. This supports KYC and network-analysis workflows on Vietnamese entities.
Fetch the shareholders and entity relationships for a company and assemble its ownership graph
15 endpoints — the fiingroup standard api provides corporate intelligence on vietnamese companies, letting you search for a company and pull its profile, industry classification, and ownership structure.
METHOD
PATH
DESCRIPTION
/api/v1/Standard/SearchCompany
Search for a company
/api/v1/Standard/CompanyInformations
Retrieve company profile information
/api/v1/Standard/Shareholders
Retrieve a company's shareholders
/api/v1/Standard/FinancialStatements
Retrieve financial statements
/api/v1/Standard/FSKeyRatios
Retrieve key financial ratios
/api/v1/Standard/CorporateRiskScores
Retrieve corporate risk scores
/api/v1/Monitoring/MonitoringDatas
Retrieve monitoring data for tracked companies
/api/v1/Standard/SearchCompany
Search for a company
/api/v1/Standard/CompanyInformations
Retrieve company profile information
/api/v1/Standard/Shareholders
Retrieve a company's shareholders
/api/v1/Standard/FinancialStatements
Retrieve financial statements
/api/v1/Standard/FSKeyRatios
Retrieve key financial ratios
/api/v1/Standard/CorporateRiskScores
Retrieve corporate risk scores
/api/v1/Monitoring/MonitoringDatas
Retrieve monitoring data for tracked companies
What agents get from Jentic-routed access to this vendor.
Setup
Wiring FiinGroup by hand means obtaining a bearer token, sending it on every request, and matching each query to the right Standard or Monitoring operation yourself. Through Jentic you install once, import FiinGroup from the API Directory, store the credential once, and your agent calls it.
Permission scoping
You choose which FiinGroup operations the agent may call, such as searching companies and reading financial statements, so operations like monitoring configuration are not included unless you add them. FiinGroup carries the company identifier in the request body, so rules bound which operations your agent may call, not which company.
Credential isolation
Your FiinGroup bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'look up a Vietnamese company' or 'pull financial statements', and Jentic returns the matching FiinGroup operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using FiinGroup Standard API through Jentic.
What authentication does the FiinGroup Standard API use?
Per its OpenAPI spec, the FiinGroup Standard API uses a bearer token sent on each request. Through Jentic the token is stored encrypted by your own instance and injected at call time, so it never reaches the agent.
Is there a FiinGroup MCP server?
You don't need an MCP server to give your agent FiinGroup. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls operations like searching a company or pulling its financial statements on demand, without loading another server's tool definitions into its context.
Can I limit what my agent is allowed to do with FiinGroup?
Yes. Write a rule that allows only the search and read operations the agent needs, such as searching companies and pulling financial statements, so it can gather data but cannot touch monitoring configuration unless you add those operations, and every call it makes is logged. FiinGroup carries the company identifier in the request body, so rules bound which operations the agent may call.
Can I retrieve financial statements with the FiinGroup Standard API?
Yes. Call the financial statements operation for a company, then fetch its financial ratios and key ratios for the same period. The data is returned structured, so an agent can load it directly into a model.
What are the rate limits for the FiinGroup Standard API?
The OpenAPI spec does not specify rate limits. Check the FiinGroup documentation on SwaggerHub at https://app.swaggerhub.com/apis/fiingroup/standard-apis for current limits before running bulk lookups.
How do I run a company check with the FiinGroup Standard API through Jentic?
Search Jentic for 'look up a Vietnamese company', which returns the search, profile, and financials operations with their input schemas. The agent searches for the company, reads its profile and shareholders, and pulls its risk score, with your stored token injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.
Know of an official OpenAPI document? Contribute it →
For Agents
Search Vietnamese companies and retrieve profiles, shareholders, relationships, financial statements, ratios, and corporate risk scores, with change monitoring. Authenticated with a bearer token.
Use for: I need to find a Vietnamese company by name, Get the financial statements for a company, Retrieve the shareholders of a company, Look up the corporate risk score for a company
Not supported: Does not handle trading, payments, or credit decisioning. Use for Vietnamese company data, financials, and risk scores only.
The FiinGroup Standard API provides corporate intelligence on Vietnamese companies, letting you search for a company and pull its profile, industry classification, and ownership structure. It returns shareholders, executive positions, and entity relationships, alongside financial statements, financial ratios, performance scores, and corporate risk scores. A monitoring endpoint surfaces changes to tracked companies. Calls are authenticated with a bearer token.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>