The CNPJ Lookup API allows developers to easily retrieve company information registered in Brazil using their CNPJ (Cadastro Nacional da Pessoa Jurídica) number. It provides instant access to corporate data such as company name, trade name, registration status, address, opening date, business activity, and much more.
Ideal for onboarding processes, fraud prevention, B2B services, or enriching business databases, this API helps you verify Brazilian companies quickly and efficiently.
Simply send a CNPJ number and get back structured JSON data with reliable and up-to-date public records.
Use cases include:
- Business validation during sign-up
- Corporate KYC (Know Your Customer)
- Financial onboarding automation
- CRM database enrichment
{
"api": {
"success": true,
"tempo": "233ms",
"tipo": "real_time"
},
"data": {
"uf": "SP",
"cep": "06454070",
"qsa": [
{
"pais": null,
"nome_socio": "DORIVAL PEREIRA DE OLIVEIRA JUNIOR",
"codigo_pais": null,
"faixa_etaria": "Entre 61 a 70 anos",
"cnpj_cpf_do_socio": "***768478**",
"qualificacao_socio": "Diretor",
"codigo_faixa_etaria": 7,
"data_entrada_sociedade": "2020-11-23",
"identificador_de_socio": 2,
"cpf_representante_legal": "***000000**",
"nome_representante_legal": "",
"codigo_qualificacao_socio": 10,
"qualificacao_representante_legal": "Não informada",
"codigo_qualificacao_representante_legal": 0
},
{
"pais": null,
"nome_socio": "ROGERIO DE MORAES BARREIRA",
"codigo_pais": null,
"faixa_etaria": "Entre 51 a 60 anos",
"cnpj_cpf_do_socio": "***175578**",
"qualificacao_socio": "Presidente",
"codigo_faixa_etaria": 6,
"data_entrada_sociedade": "2021-05-03",
"identificador_de_socio": 2,
"cpf_representante_legal": "***000000**",
"nome_representante_legal": "",
"codigo_qualificacao_socio": 16,
"qualificacao_representante_legal": "Não informada",
"codigo_qualificacao_representante_legal": 0
}
],
"cnpj": "42591651000143",
"pais": null,
"email": null,
"porte": "DEMAIS",
"bairro": "ALPHAVILLE INDUSTRIAL",
"numero": "253",
"ddd_fax": "1141969800",
"municipio": "BARUERI",
"logradouro": "AMAZONAS",
"cnae_fiscal": 5611203,
"codigo_pais": null,
"complemento": "",
"codigo_porte": 5,
"razao_social": "ARCOS DOURADOS COMERCIO DE ALIMENTOS SA",
"nome_fantasia": "",
"capital_social": 442788930,
"ddd_telefone_1": "1141969800",
"ddd_telefone_2": "",
"opcao_pelo_mei": null,
"codigo_municipio": 6213,
"cnaes_secundarios": [
{
"codigo": 4763601,
"descricao": "Comércio varejista de brinquedos e artigos recreativos"
},
{
"codigo": 5611201,
"descricao": "Restaurantes e similares"
},
{
"codigo": 7740300,
"descricao": "Gestão de ativos intangíveis não-financeiros"
},
{
"codigo": 8211300,
"descricao": "Serviços combinados de escritório e apoio administrativo"
}
],
"natureza_juridica": "Sociedade Anônima Fechada",
"regime_tributario": [
{
"ano": 2015,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2016,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2017,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2018,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2019,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2020,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2021,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2022,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2023,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
}
],
"situacao_especial": "",
"opcao_pelo_simples": null,
"situacao_cadastral": 2,
"data_opcao_pelo_mei": null,
"data_exclusao_do_mei": null,
"cnae_fiscal_descricao": "Lanchonetes, casas de chá, de sucos e similares",
"codigo_municipio_ibge": 3505708,
"data_inicio_atividade": "1977-01-17",
"data_situacao_especial": null,
"data_opcao_pelo_simples": null,
"data_situacao_cadastral": "2005-11-03",
"nome_cidade_no_exterior": "",
"codigo_natureza_juridica": 2054,
"data_exclusao_do_simples": null,
"motivo_situacao_cadastral": 0,
"ente_federativo_responsavel": "",
"identificador_matriz_filial": 1,
"qualificacao_do_responsavel": 16,
"descricao_situacao_cadastral": "ATIVA",
"descricao_tipo_de_logradouro": "ALAMEDA",
"descricao_motivo_situacao_cadastral": "SEM MOTIVO",
"descricao_identificador_matriz_filial": "MATRIZ"
}
}
curl --location --request GET 'https://zylalabs.com/api/8386/cnpj+api/14654/cnpj?cnpj=42591651000143' --header 'Authorization: Bearer YOUR_API_KEY'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime.
The CNPJ API returns detailed company information, including the company name, trade name, registration status, address, opening date, business activity, and partner details. This data is structured in JSON format for easy integration.
Key fields in the response include "uf" (state), "cep" (postal code), "qsa" (partner information), and "success" status. Each partner entry contains details like name, age range, and qualification status.
The response is structured in a JSON format with a top-level "api" object indicating success and response time, followed by a "data" object containing company details and an array of partners (qsa).
The API provides information on company registration, including legal status, address, business activities, and details about partners and representatives, making it suitable for KYC and business validation.
The CNPJ API sources its data from official Brazilian public records, ensuring high accuracy. Regular updates and checks are performed to maintain data integrity and reliability.
Typical use cases include verifying company legitimacy during onboarding, conducting KYC checks, automating financial onboarding processes, and enriching CRM databases with accurate company information.
Users can customize requests by sending a CNPJ number, with or without punctuation. The API is designed to handle both formats, but using digits only is recommended for optimal results.
If results are partial or empty, users should verify the CNPJ number for accuracy. Additionally, they can check if the company is newly registered or if there are temporary data issues in the public records.
The CNPJ API allows you to retrieve various company details, including the legal name, trade name, registration status, address, opening date, business activities, and information about partners and representatives, such as their names and qualifications.
Yes, the CNPJ API covers company data across all Brazilian states (UFs). Each response includes the state information, allowing you to identify the location of the registered company.
The response time for the CNPJ API is typically indicated in the "tempo" field of the response. This value reflects the time taken to process the request and return the data, usually in milliseconds.
To ensure accuracy, always provide a valid CNPJ number without punctuation. This helps the API process your request effectively and reduces the likelihood of receiving partial or empty results.
The "qsa" field contains an array of partner information, detailing each partner's name, age range, qualification status, and entry date into the company. This is crucial for understanding the ownership structure.
The CNPJ API returns data in JSON format, which is widely used for API responses. This structured format makes it easy to parse and integrate the data into applications.
If you encounter an error, check the CNPJ number for accuracy and ensure it is formatted correctly. If the issue persists, consult the API documentation for troubleshooting tips or contact support for assistance.
The partner information can be used for various purposes, such as conducting due diligence, verifying ownership, and assessing the credibility of a business during KYC processes or financial assessments.
To obtain your API key, you first need to sign in to your account and subscribe to the API you want to use. Once subscribed, go to your Profile, open the Subscription section, and select the specific API. Your API key will be available there and can be used to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
If you don’t cancel before the 7th day, your free trial will end automatically and your subscription will switch to a paid plan under the same plan you originally subscribed to, meaning you will be charged and gain access to the API calls included in that plan.
The free trial ends when you reach 50 API requests or after 7 days, whichever comes first.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost, so you can test our APIs without any commitment.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
Service Level:
100%
Response Time:
203ms
Service Level:
100%
Response Time:
787ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
481ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
1,341ms
Service Level:
100%
Response Time:
770ms
Service Level:
100%
Response Time:
1,289ms
Service Level:
100%
Response Time:
1,736ms
Service Level:
100%
Response Time:
1,301ms
Service Level:
100%
Response Time:
1,655ms
Service Level:
100%
Response Time:
2,109ms
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
856ms
Service Level:
100%
Response Time:
894ms