Tools reference
Generated from the tool schemas of the api. The REST endpoints and the MCP tools are the same tools with the same prices. Every answer carries meta.source, meta.fetched_at, meta.data_as_of and meta.cached.
lookup_company
1 credit per answer. Countries: RO.
Look up one company in an official business registry: name, legal form, status, registration number, VAT status, address, NACE code. Charged 1 credit(s) for every definitive answer, including not found; not charged when the upstream registry is unavailable.
REST: GET /v1/{country}/companies/{id}
MCP tool name: lookup_company
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code, uppercase. Always explicit, never guessed.one of RO; pattern ^[A-Z]{2}$ |
id | string | yes | Registry id of the company. Romania: the CUI, digits only, no RO prefix, e.g. 14399840.pattern ^[0-9]+$; max length 20 |
company_status
1 credit per answer. Countries: RO.
Current status of one company: active, inactive or radiated, with the inactivity and radiation dates the registry publishes. Charged 1 credit(s) for every definitive answer, including not found; not charged when the upstream registry is unavailable.
REST: GET /v1/{country}/companies/{id}/status
MCP tool name: company_status
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code, uppercase. Always explicit, never guessed.one of RO; pattern ^[A-Z]{2}$ |
id | string | yes | Registry id of the company. Romania: the CUI, digits only, no RO prefix, e.g. 14399840.pattern ^[0-9]+$; max length 20 |
validate_vat
1 credit per answer. Countries: RO.
Check whether a company is registered for VAT, with the registration periods the registry publishes. Charged 1 credit(s) for every definitive answer, including not found; not charged when the upstream registry is unavailable.
REST: GET /v1/vat/{vat_number}
REST takes no country parameter: vat_number must carry the uppercase country prefix, e.g. RO14399840
MCP tool name: validate_vat
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code, uppercase. Always explicit, never guessed.one of RO; pattern ^[A-Z]{2}$ |
vat_number | string | yes | VAT number, with or without the country prefix. Romania: RO14399840 or 14399840.pattern ^(?:[A-Z]{2})?[0-9]+$; max length 24 |
search_company
1 credit per answer. Countries: RO.
Find companies by name: every word is matched as a prefix, best match first. Returns the registry id, name, legal form, status and county/city of up to `limit` companies (never full records); diacritics are not folded yet. Charged 1 credit(s) for every definitive answer, including not found; not charged when the upstream registry is unavailable.
REST: GET /v1/{country}/companies?name=&limit=
name is a query parameter (2 to 100 characters); limit is optional, 1 to 25, default 10
MCP tool name: search_company
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code, uppercase. Always explicit, never guessed.one of RO; pattern ^[A-Z]{2}$ |
name | string | yes | Company name or its first words; every word is matched as a prefix.min length 2; max length 100 |
limit | integer | no | Maximum number of hits.min 1; max 25; default 10 |
company_officers
2 credits per answer. Countries: RO.
Administrators and other legal representatives of one company as published by the registry (name and role, with source and snapshot date). No personal ID numbers. Charged 2 credit(s) for every definitive answer, including not found; not charged when the upstream registry is unavailable.
REST: GET /v1/{country}/companies/{id}/officers
MCP tool name: company_officers
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code, uppercase. Always explicit, never guessed.one of RO; pattern ^[A-Z]{2}$ |
id | string | yes | Registry id of the company. Romania: the CUI, digits only, no RO prefix, e.g. 14399840.pattern ^[0-9]+$; max length 20 |
company_financials
2 credits per answer. Countries: RO.
Annual balance sheet indicators of one company for one year, exactly as the registry published them (Romania: ANAF; the currency is not stated by the registry and is assumed to be RON). Charged 2 credit(s) for every definitive answer, including not found; not charged when the upstream registry is unavailable.
REST: GET /v1/{country}/companies/{id}/financials?year=
MCP tool name: company_financials
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code, uppercase. Always explicit, never guessed.one of RO; pattern ^[A-Z]{2}$ |
id | string | yes | Registry id of the company. Romania: the CUI, digits only, no RO prefix, e.g. 14399840.pattern ^[0-9]+$; max length 20 |
year | integer | yes | Financial year of the balance sheet.min 2000; max 2026 |
screen_sanctions
5 credits per answer. Countries: any.
Screen a person or company name against sanctions, PEP and watch lists (OpenSanctions): scored candidates with the lists they appear on. A match score is not a risk verdict. Charged 5 credit(s) for every definitive answer, including not found; not charged when the upstream registry is unavailable.
REST: POST /v1/sanctions/screen
POST with a JSON body {name, country?}; country is an optional uppercase ISO 3166-1 alpha-2 filter
MCP tool name: screen_sanctions
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Person or company name to screen.min length 2; max length 200 |
country | string | no | Optional ISO 3166-1 alpha-2 country code, uppercase, to narrow the candidates. Any country; it is a filter, not a registry.pattern ^[A-Z]{2}$ |
kyb_report
8 credits + 5 per officer screened, max 5 officers; former officers only with include_former_officers per answer. Countries: RO.
One answer for know-your-business checks: registry record, status, VAT status, officers, and a sanctions screening of the company name and of the current officers on file (former ones on request), each section with its own source and dates. Charged 8 credits + 5 per officer screened, max 5 officers; former officers only with include_former_officers. Not found is charged the base; not charged when the upstream registry is unavailable.
REST: GET /v1/{country}/companies/{id}/kyb?include_former_officers=
include_former_officers=true also screens former officers (same price per name, same cap)
MCP tool name: kyb_report
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code, uppercase. Always explicit, never guessed.one of RO; pattern ^[A-Z]{2}$ |
id | string | yes | Registry id of the company. Romania: the CUI, digits only, no RO prefix, e.g. 14399840.pattern ^[0-9]+$; max length 20 |
include_former_officers | boolean | no | Also screen former officers (those with an end date in the registry data); same price per name, same cap.default false |