“通过税号获取公司数据”端点旨在使用公司的唯一税务识别号(TIN)获取详细信息。该端点作为企业、金融机构和监管机构的重要工具,帮助验证公司基于其分配的税号的身份、法律地位和运营细节。成功调用后,它返回一个结构化的JSON响应,包含公司名称、地址、注册状态、行业分类和联系信息等基本数据字段。潜在的用例包括并购过程中的合规检查、欺诈检测、税务报告以及确保开票和金融交易的客户记录准确。
{"cnpj":"33000167000101","identificador_matriz_filial":"Matriz","razao_social":"PETROLEO BRASILEIRO S A PETROBRAS","nome_fantasia":"PETROBRAS - EDISE","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"data_situacao_cadastral":"2005-11-03","motivo_situacao_cadastral":{"codigo":"00","descricao":"SEM MOTIVO"},"data_inicio_atividade":"1966-09-28","natureza_juridica":{"codigo":"2038","descricao":"Sociedade de Economia Mista"},"qualificacao_responsavel":{"codigo":"10","descricao":"Diretor"},"capital_social":205431960490.52,"porte":{"codigo":"05","descricao":"Demais"},"ente_federativo":null,"cnae_fiscal_principal":{"codigo":"0600001","descricao":"Extração de petróleo e gás natural"},"cnaes_fiscais_secundarios":[{"codigo":"1921700","descricao":"Fabricação de produtos do refino de petróleo"},{"codigo":"3520401","descricao":"Produção de gás; processamento de gás natural"},{"codigo":"3520402","descricao":"Distribuição de combustíveis gasosos por redes urbanas"},{"codigo":"4681801","descricao":"Comércio atacadista de álcool carburante, biodiesel, gasolina e demais derivados de petróleo, exceto lubrificantes, não realizado por transportador re"},{"codigo":"8630599","descricao":"Atividades de atenção ambulatorial não especificadas anteriormente"}],"endereco":{"tipo_logradouro":"AVENIDA","logradouro":"REPUBLICA DO CHILE","numero":"65","complemento":null,"bairro":"CENTRO","cep":"20031170","uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},"nome_cidade_exterior":null,"pais":null,"telefones":[{"ddd":"21","numero":"21660000"}],"fax":{"ddd":"21","numero":"3224"},"correio_eletronico":"[email protected]","situacao_especial":null,"data_situacao_especial":null,"simples_nacional":null,"mei":null,"socios":[{"tipo":"Pessoa Física","nome":"CLAUDIO ROMEO SCHLOSSER","cpf_cnpj":"***077120**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"WILLIAM FRANCA DA SILVA","cpf_cnpj":"***487787**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"CLARICE COPPETTI","cpf_cnpj":"***995240**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"MAGDA MARIA DE REGINA CHAMBRIARD","cpf_cnpj":"***612937**","qualificacao":{"codigo":"16","descricao":"Presidente"},"data_entrada":"2024-06-07","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"FERNANDO SABBI MELGAREJO","cpf_cnpj":"***650110**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"SYLVIA MARIA COUTO DOS ANJOS","cpf_cnpj":"***701217**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"RENATA FARIA RODRIGUES BARUZZI LOPES","cpf_cnpj":"***944618**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"RICARDO WAGNER DE ARAUJO","cpf_cnpj":"***017831**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2025-04-25","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"ANGELICA GARCIA COBAS LAUREANO","cpf_cnpj":"***912137**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2025-07-29","pais":null,"faixa_etaria":"61 a 70 anos","representante":null}],"has_branches":true}
curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23444/company+data+by+tax+id&cnpj=Required' --header 'Authorization: Bearer YOUR_API_KEY'
“列出分支机构”终端旨在检索与特定组织或网络相关的所有分支机构的综合列表。此终端的目的是让用户访问关键细节,例如办公室名称、位置、联系信息和运营状态,从而促进对各个地区组织存在的有效管理和监督。此终端的典型使用案例包括生成战略规划报告、支持与分支服务相关的客户查询,以及通过确保团队掌握所有运营分支的最新信息来提高服务交付。如果此终端返回空列表,则表示该公司没有分支机构。请参考“按税号查询公司数据”终端上的 has_branches 字段,以避免不必要的 API 调用。
列出分支机构 - 端点功能
| 对象 | 描述 |
|---|---|
page |
[必需] The page you wish to retrieve |
cnpj |
[必需] |
{"cnpj_matriz":"33000167000101","total_filiais":656,"page":1,"total_pages":14,"filiais":[{"cnpj":"33000167000292","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},{"cnpj":"33000167000373","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RN","municipio":{"codigo":"1687","descricao":"GUAMARE"}},{"cnpj":"33000167000454","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"ES","municipio":{"codigo":"5705","descricao":"VITORIA"}},{"cnpj":"33000167000535","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"PE","municipio":{"codigo":"2513","descricao":"PAULISTA"}},{"cnpj":"33000167000616","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"08","descricao":"Baixada"},"uf":"PB","municipio":{"codigo":"1937","descricao":"BAYEUX"}},{"cnpj":"33000167000705","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"08","descricao":"Baixada"},"uf":"CE","municipio":{"codigo":"1389","descricao":"FORTALEZA"}},{"cnpj":"33000167000888","nome_fantasia":"PETROLEO BRASILEIRO S. A. - PETROBRAS","situacao_cadastral":{"codigo":"08","descricao":"Baixada"},"uf":"AL","municipio":{"codigo":"2837","descricao":"PILAR"}},{"cnpj":"33000167000969","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RN","municipio":{"codigo":"1759","descricao":"MOSSORO"}},{"cnpj":"33000167001000","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"08","descricao":"Baixada"},"uf":"PA","municipio":{"codigo":"0427","descricao":"BELEM"}},{"cnpj":"33000167001183","nome_fantasia":null,"situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"PR","municipio":{"codigo":"7745","descricao":"PARANAGUA"}},{"cnpj":"33000167001264","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SC","municipio":{"codigo":"8161","descricao":"ITAJAI"}},{"cnpj":"33000167001345","nome_fantasia":"ESJAP","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"EX","municipio":{"codigo":"9707","descricao":"EXTERIOR"}},{"cnpj":"33000167001426","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SP","municipio":{"codigo":"6969","descricao":"RIBEIRAO PRETO"}},{"cnpj":"33000167001507","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},{"cnpj":"33000167001698","nome_fantasia":"PETROLEO BRASILEIRO S. A. - PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5899","descricao":"SAO JOAO DA BARRA"}},{"cnpj":"33000167001779","nome_fantasia":null,"situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SC","municipio":{"codigo":"8045","descricao":"BIGUACU"}},{"cnpj":"33000167001850","nome_fantasia":"PETROLEO BRASILEIRO S. A. - PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},{"cnpj":"33000167001930","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"DF","municipio":{"codigo":"9701","descricao":"BRASILIA"}},{"cnpj":"33000167002074","nome_fantasia":"PETROLEO BRASILEIRO S. A. - PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SE","municipio":{"codigo":"3111","descricao":"BARRA DOS COQUEIROS"}},{"cnpj":"33000167002155","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"GO","municipio":{"codigo":"9753","descricao":"SENADOR CANEDO"}},{"cnpj":"33000167002236","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"MG","municipio":{"codigo":"5403","descricao":"UBERLANDIA"}},{"cnpj":"33000167002317","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"MG","municipio":{"codigo":"4595","descricao":"IBIRITE"}},{"cnpj":"33000167002406","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"BA","municipio":{"codigo":"3883","descricao":"SAO FRANCISCO DO CONDE"}},{"cnpj":"33000167002589","nome_fantasia":"PETROLEO BRASILEIRO S. A. - PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"ES","municipio":{"codigo":"5699","descricao":"SERRA"}},{"cnpj":"33000167002660","nome_fantasia":"PETROBRAS - UTE NOVA PIRATININGA","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SP","municipio":{"codigo":"7107","descricao":"SAO PAULO"}},{"cnpj":"33000167002740","nome_fantasia":"PETROBRAS P-35","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167002821","nome_fantasia":"PETROLEO BRASILEIRO S/A PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SC","municipio":{"codigo":"8127","descricao":"GUARAMIRIM"}},{"cnpj":"33000167002902","nome_fantasia":"PETROBRAS P-47","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167003046","nome_fantasia":"PETROBRAS P-33","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167003127","nome_fantasia":"PETROBRAS P-32","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167003208","nome_fantasia":"PLATAFORMA - BARRA DO FURADO","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6007","descricao":"QUISSAMA"}},{"cnpj":"33000167003399","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167003470","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"08","descricao":"Baixada"},"uf":"BA","municipio":{"codigo":"3849","descricao":"SALVADOR"}},{"cnpj":"33000167003550","nome_fantasia":"CONSORCIO BM-S-24 (BE)","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},{"cnpj":"33000167003631","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},{"cnpj":"33000167003712","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SE","municipio":{"codigo":"3171","descricao":"LARANJEIRAS"}},{"cnpj":"33000167003801","nome_fantasia":"CONSORCIO ALBACORA LESTE (ICC)","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167003984","nome_fantasia":"CONSORCIO PAPA-TERRA (CP)","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167004018","nome_fantasia":"PETROBRAS - CONSORCIO BM-S-21","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SP","municipio":{"codigo":"7071","descricao":"SANTOS"}},{"cnpj":"33000167004107","nome_fantasia":"PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"CE","municipio":{"codigo":"1505","descricao":"PARACURU"}},{"cnpj":"33000167004280","nome_fantasia":"CONSORCIO CERNAMBI (CP)","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},{"cnpj":"33000167004360","nome_fantasia":"PETROBRAS - CONSORCIO BM-S-10","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},{"cnpj":"33000167004441","nome_fantasia":"PETROBRAS - CONSORCIO BM-S-08","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SP","municipio":{"codigo":"7071","descricao":"SANTOS"}},{"cnpj":"33000167004522","nome_fantasia":"PETROLEO BRASILEIRO S/A PETROBRAS","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SC","municipio":{"codigo":"8161","descricao":"ITAJAI"}},{"cnpj":"33000167004603","nome_fantasia":"PETROBRAS - CONSORCIO BM-C-3","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"RJ","municipio":{"codigo":"5847","descricao":"MACAE"}},{"cnpj":"33000167004794","nome_fantasia":"CONSORCIO SAPINHOA UNIT:PB45LIDER/SHELL30/REP25","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SP","municipio":{"codigo":"6371","descricao":"CUBATAO"}},{"cnpj":"33000167004875","nome_fantasia":"PETROBRAS - CONSORCIO BM-ES-05","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"ES","municipio":{"codigo":"5705","descricao":"VITORIA"}},{"cnpj":"33000167004956","nome_fantasia":"PETROBRAS - CONSORCIO BM-C-25","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"ES","municipio":{"codigo":"5705","descricao":"VITORIA"}},{"cnpj":"33000167005090","nome_fantasia":"PETROBRAS - CONSORCIO BM-ES-9","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"ES","municipio":{"codigo":"5705","descricao":"VITORIA"}},{"cnpj":"33000167005170","nome_fantasia":"PETROBRAS - CONSORCIO BM-S-12","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"uf":"SC","municipio":{"codigo":"8161","descricao":"ITAJAI"}}]}
curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23462/list+branch+offices?page=1&cnpj=Required' --header 'Authorization: Bearer YOUR_API_KEY'
调用此端点以检查API是否处于活动状态并正常运行
{"status":"ok","last_import":{"batch":"2026-04","status":"success","started_at":"2026-04-19T19:12:29.446800","finished_at":"2026-04-19T21:04:42.147052"}}
curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23445/status+check' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
每个端点返回有关巴西法律实体的详细信息 “按税号获取公司数据”端点提供注册状态 公司名称 地址 联系信息和行业分类 “列出分支机构”端点返回有关分支机构的详细信息,包括名称 位置和运营状态
关键字段包括CNPJ,公司名称(razao_social),贸易名称(nome_fantasia),注册状态(situacao_cadastral),开业日期(data_inicio_atividade),法律性质(natureza_juridica)和联系信息。对于分支机构,字段包括分支CNPJ、名称和状态
响应数据以JSON格式结构化,每个字段都有键值对。例如“按税号获取企业数据”的响应包括嵌套对象用于注册状态和法律性质,便于分析和使用特定信息
“通过税号获取公司数据”端点提供了有关公司注册 状态和活动的全面信息 “列出分支机构”端点提供所有关联分支的信息 包括它们的运营状态和位置
数据直接来源于巴西联邦税务局(Receita Federal),确保高准确性和可靠性 定期进行更新和质量检查以维护通过API提供的信息的完整性
典型的使用案例包括并购的合规检查欺诈检测税务报告以及验证客户记录以便开具发票 企业还可以利用分支机构的数据进行战略规划和客户询问
用户可以通过指定CNPJ来定制请求以获取“通过税务ID获取企业数据”端点,或者在检索分支机构数据时根据特定标准过滤结果。这允许针对性的信息检索
用户可以期待一致的 JSON 响应和结构化数据。例如 "situacao_cadastral" 字段将始终指示注册状态,而 "cnae_fiscal_principal" 将提供主要行业分类,方便数据解释
此端点提供有关公司的详细信息,包括其CNPJ、公司名称、商业名称、注册状态、开业日期、法律性质、注册资本和行业分类(CNAE)这使用户能够验证实体的身份和法律状态
此端点返回与公司相关的分支机构列表,包括每个分支机构的CNPJ、商业名称、注册状态、位置(州和市)以及分支机构总数。这对于管理组织的区域存在很有帮助
API的响应为JSON格式,组织为键值对。例如,在“按税号获取企业数据”中,注册状态和法律性质的数据是嵌套的,这使得信息的解释和使用更加方便
用户可以在“按税号获取公司数据”的端点中指定CNPJ作为参数。要“列出分支机构”,可以通过母公司的CNPJ进行过滤,以获取有关其分支机构的特定信息
数据直接来自巴西联邦税务局确保其准确性此外还实施质量控制和定期更新以维护信息的完整性
这些字段中的代码代表特定类别。例如,在“situacao_cadastral”中的代码“02”表示公司处于活动状态,而在“natureza_juridica”中的代码“2062”指的是“有限责任公司”这允许标准化分类
如果请求没有返回结果,用户应检查提供的CNPJ的有效性。如果有部分结果,建议检查搜索参数或考虑该公司没有注册分支机构的可能性
数据通常用于并购中的合规性检查、欺诈检测、税务报告和客户记录验证。它们对于战略规划和在不同地区的分支管理也很有用
“列出分支机构”端点提供了与公司相关的分支机构的全面列表,包括每个分支的CNPJ、商业名称、注册状态、位置(州和市)以及分支总数。这些数据对于了解组织的区域存在非常重要
您可以通过使用“按税号查询公司数据”端点来验证公司的运营状态,其中包含“situacao_cadastral”字段。该字段指示公司是活跃还是非活跃,为合规和验证流程提供了重要信息
字段“qualificacao_responsavel”指的是公司负责人资格,例如“Sócio-Administrador”(合伙人-管理者)这有助于识别参与公司管理和决策的关键人员
是的,当使用“列出分支机构”端点时,您可以根据母公司的CNPJ过滤结果。这使您能够检索特定组织的分支信息,提高数据与您需求的相关性
“capital_social”字段代表公司的股本,这对于理解其财务基础至关重要。这些信息可以用于财务评估、投资决策以及评估公司的规模和稳定性
“data_inicio_atividade”字段指示公司开始运营的时间 此信息对于评估公司的市场经验 评估其增长潜力以及进行合规性或投资目的的历史分析非常有用
“motivo_situacao_cadastral”字段提供了一个代码和描述,解释公司的注册状态原因。例如,“00”代码表示“SEM MOTIVO”(无理由),这可以帮助用户理解公司当前状态的背景
为了确保CNPJ值有效,请检查CNPJ格式是否正确(14位数字)并且是否对应于一个存在的实体如果请求没有返回结果,请再次核实CNPJ以获取更高的准确性或考虑该实体可能未在联邦税务局数据库中注册
服务级别:
100%
响应时间:
787ms
服务级别:
100%
响应时间:
965ms
服务级别:
100%
响应时间:
2,363ms
服务级别:
100%
响应时间:
20,002ms
服务级别:
100%
响应时间:
42ms
服务级别:
100%
响应时间:
1,748ms
服务级别:
100%
响应时间:
20,003ms
服务级别:
100%
响应时间:
3,560ms
服务级别:
100%
响应时间:
20,003ms