Americas • ISO BR
Verify Brazil companies via API
Know Your Customer Limited verifies Brazil companies live from the Jucesp Online, returning company data, controlling parties, shareholders and beneficial owners, and registry documents, with AML screening and ongoing monitoring. Free sandbox available.
What the API returns for Brazil
When you create a KYB case for a Brazil company, Know Your Customer Limited retrieves data live from the Jucesp Online. A single integration returns the company record, the controlling parties and individuals, the shareholders and beneficial owners, and the registry documents, with AML screening on the entity and its associated individuals built into the same case.
Brazil data and document availability
What the API makes available for Brazil companies:
| Category | Available |
|---|---|
| Company data | Entity Name, Entity Type, Entity Status, Registration Number, Address, Registration Date, Activity Type, Capital, Tax Identification Number |
| Controlling entities & individuals | Name, Address, Role, Tax Identification Number, National Country ID |
| Shareholders & beneficial owners | Name, Address, Role, Share count, Tax Identification Number, National Country ID |
| Documents | Retrieved by default: Registry Extract Available on demand: Ficha Cadastral Completa (Complete Registration Form), Ficha Cadastral Simplificada (dados atuais da empresa) (Simplified Registration Form (current company data)), Cópia Digitalizada de Documentos Arquivados (cópia simples – não tem valor jurídico de certidão) (Scanned Copy of Archived Documents (simple copy – has no legal certificate value)), Certidão Específica Pré-formatada (Pre-formatted Specific Certificate), Certidão Específica com Teor Solicitado (Specific Certificate with Requested Content), Certidão Específica com Teor Solicitado – Registro de Livros (Specific Certificate with Requested Content – Book Registration), Certidão de Inteiro Teor (Full Content Certificate), Solicitação de Correção de Dados Cadastrais (Registration Data Correction Request) |
AML, sanctions, and PEP screening on the entity and its associated individuals, and ongoing live monitoring with change alerts, are available for Brazil as part of the same case.
How to verify a Brazil company via API
The following example shows the complete flow: authenticate, search the Brazil registry, create a KYB case, and retrieve company data and the ownership org-chart. All calls go to the sandbox base URL for testing.
The sandbox at https://api.knowyourcustomer.dev is free. Request access to get your client credentials.
# 1. Authenticate (OAuth2 client credentials)
curl -X POST https://api.knowyourcustomer.dev/connect/token \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "scope=PublicApi"
# 2. Search the Brazil registry
curl -X POST https://api.knowyourcustomer.dev/v2/Companies/search \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Brazil National Bank","codeiso31662":"BR"}'
# 3. Create a KYB case
curl -X POST https://api.knowyourcustomer.dev/v2/Companies \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"rawname":"Brazil National Bank","codeiso31662":"BR"}'
# 4. Retrieve company data and status
curl https://api.knowyourcustomer.dev/v2/Companies/CASE_ID \
-H "Authorization: Bearer $TOKEN"
# 5. Get the beneficial ownership org-chart
curl https://api.knowyourcustomer.dev/v2/Companies/CASE_ID/org-chart \
-H "Authorization: Bearer $TOKEN"
Replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with your sandbox credentials, and CASE_ID with the caseCommonId returned in step 3.
Frequently asked questions about the Brazil KYB API
What company data can I verify in Brazil?
For a Brazil company, the API returns the company record read live from the Jucesp Online: the entity name, type, status, registration number, address, and registration date, along with the controlling parties, the shareholders and beneficial owners, and the available registry documents. See the table above for the full Brazil availability.
Does the API return beneficial ownership (UBO) data for Brazil companies?
The API resolves the controlling parties, shareholders, and beneficial owners for Brazil companies and exposes them as a recursive ownership org-chart (GET /v2/Companies/{caseCommonId}/org-chart), tracing control through holding companies to the individual beneficial owners. The depth available depends on what the Jucesp Online discloses. See the UBO API.
Can I retrieve official registry documents for Brazil companies?
Yes. The default document set for Brazil includes Registry Extract, retrieved by default, with additional documents available on demand (Ficha Cadastral Completa (Complete Registration Form), Ficha Cadastral Simplificada (dados atuais da empresa) (Simplified Registration Form (current company data)), Cópia Digitalizada de Documentos Arquivados (cópia simples – não tem valor jurídico de certidão) (Scanned Copy of Archived Documents (simple copy – has no legal certificate value)), Certidão Específica Pré-formatada (Pre-formatted Specific Certificate), Certidão Específica com Teor Solicitado (Specific Certificate with Requested Content), Certidão Específica com Teor Solicitado – Registro de Livros (Specific Certificate with Requested Content – Book Registration), and more). List and download them with the documents endpoint (GET /v2/Companies/{caseCommonId}/documents).
Is there a free sandbox for testing Brazil company verification?
Yes. The Know Your Customer sandbox at https://api.knowyourcustomer.dev is a free, high-fidelity test environment. Request free sandbox access to start testing.
The Know Your Customer Limited API covers 147 jurisdictions worldwide, including Brazil. One integration, one set of credentials, one response schema across all markets. Browse all covered jurisdictions.
Related coverage: British Virgin Islands • Cayman Islands • Anguilla • Argentina • Aruba • Bahamas.
Ready to verify Brazil companies?
The sandbox is free and available immediately. Integrate once, cover 147 jurisdictions.