Find a company by NIF
company_by_nifLook up a company by NIF/CIF. Use it for a tax ID; for names, search_companies. On a hit, call company_history with company_slug.
Returns {found, company_slug, current_name, website, lei, nif_caveat, ...}; use current_name. lei: GLEIF Legal Entity Identifier matched by NIF; null means no match yet. website: newest BORME website act; null if none or removed.
BORME has no dedicated tax-ID field: more than 580,000 NIF mappings from public sources and the text of BORME notices cover a minority of companies. reason nif_unmapped: not matched yet, not proof of absence. reason nif_revoked: AEAT records a revocation; relay tell_the_user. On a company match, relay nif_status.note if present. invalid_input true: not a NIF/CIF. reason nif_check_character_failed: relay tell_the_user and did_you_mean. reason not_registry_entity: explain entity_type. ambiguous true: ask which one. nif_caveat: say the link is not settled.
Read-only. Basic plan+. API key: X-API-Key (https://bormeapi.com/account).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"nif": "<nif>"
},
"name": "company_by_nif"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nif | Yes | Spanish NIF/CIF, normally 9 characters, e.g. B12345674. Spaces, hyphens, dots and the ES VAT prefix (ESB12345674) are accepted; other country prefixes are not. |