canonical: https://jentic.com/apis/fiingroup.vn/fiingroup

# Fiingroup Vn FiinGroup Standard API

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.

## For AI agents

Search Vietnamese companies and retrieve profiles, shareholders, relationships, financial statements, ratios, and corporate risk scores, with change monitoring. Authenticated with a bearer token.

## Scope

Does not handle trading, payments, or credit decisioning. Use for Vietnamese company data, financials, and risk scores only.

## Capabilities

- 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
- Monitor tracked companies for changes to their data

## Use cases

### 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: Fetch the shareholders and entity relationships for a company and assemble its ownership graph

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/v1/Standard/SearchCompany` | Search for a company |
| POST | `/api/v1/Standard/CompanyInformations` | Retrieve company profile information |
| POST | `/api/v1/Standard/Shareholders` | Retrieve a company's shareholders |
| POST | `/api/v1/Standard/FinancialStatements` | Retrieve financial statements |
| POST | `/api/v1/Standard/FSKeyRatios` | Retrieve key financial ratios |
| POST | `/api/v1/Standard/CorporateRiskScores` | Retrieve corporate risk scores |
| POST | `/api/v1/Monitoring/MonitoringDatas` | Retrieve monitoring data for tracked companies |

## Key resources

- **Company** — Search companies and retrieve profiles, VSIC classifications, and overviews
- **Relationships** — Read shareholders, positions, and entity and other relationships
- **Financials** — Retrieve financial statements, financial ratios, and key ratios
- **Scores** — Read performance scores and corporate risk scores
- **Monitoring** — Surface changes to tracked companies

## AI readiness

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.

- **Score:** 51 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 75 / 100
  - AI-Readiness & Agent Experience: 35 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 23 / 100
- **View full report:** https://jentic.com/apis/fiingroup.vn/fiingroup/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **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 handling:** 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.
- **Discovery method:** 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.

## Related APIs

- **OpenCorporates** — Open registry data on companies worldwide
- **Crunchbase** — Company profiles, funding, and investor data
- **Clearbit** — Firmographic and technographic company enrichment
- **People Data Labs** — Enrich the people and executives tied to a company

## FAQ

### 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.