br_company_list
Read-only
Prospecting list: one page of 100 ACTIVE Brazilian establishments matching a filter (CNAE code or prefix, state/UF, city, opening date range, headquarters only), with CNPJ, legal and trade name, city/state, main activity and opening date. Stable paging by CNPJ; total and next_page included. Source: Receita Federal monthly registry; MEI owners' CPFs masked. Signed answer (Ed25519 attestation), verifiable at /v1/verify.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Municipality name (accents and case ignored). | |
| cnae | No | CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division). | |
| page | No | Page of 100, default 1. | |
| state | No | UF, e.g. 'SP'. | |
| hq_only | No | Only headquarters (one row per company). | |
| opened_after | No | Opened on or after (YYYY-MM-DD). | |
| opened_before | No | Opened on or before (YYYY-MM-DD). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| total | Yes | ||
| cached | Yes | ||
| filters | Yes | ||
| receipt | No | Re-read this answer free for 10 minutes with br_replay. | |
| results | Yes | ||
| sources | Yes | ||
| summary | Yes | Short summary in English and Portuguese. | |
| next_page | Yes | ||
| page_size | Yes | ||
| attestation | No | Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json. | |
| total_pages | Yes | ||
| generated_at | Yes | ||
| data_freshness | Yes | ||
| reference_month | Yes |