GET /api/v1/entity/{id}
The full registry record — by search-result id, or directly by official registration number.
Request
| FORM | DESCRIPTION |
|---|
/api/v1/entity/{id} | By entity id from search results. |
/api/v1/entity?country=BR®istrationNumber=07918048 | By official number — no prior search. 422 unsupported_lookup_for_country where the registry has no number-lookup. |
Response
| FIELD | DESCRIPTION |
|---|
id | The requested id. |
country | ISO country code, derived from the id. |
detail | The registry-native record — shape varies by the source registry. |
Errors
| STATUS | CODE | WHEN |
|---|
| 403 | country_not_entitled | The id belongs to a country outside your key. |
| 404 | unknown_id | The id prefix matches no connected registry. |
| 404 | not_found | The registry has no record for this id. |
Example
curl -H "x-api-key: vk_live_…" "https://app.verety.ai/api/v1/entity/cnpj-07918048"
{
"id": "cnpj-07918048", "country": "BR",
"detail": { "entity": { "name": "…", "cnpjBasico": "07918048", "capitalSocial": … },
"establishments": […status, address, CNAE, contacts…],
"socios": […ownership…] }
}