您将获得
企业登记信息， 一次响应全部返回。
公开的 CNPJ 数据整理为 JSON，可直接存入您的系统。
身份与登记状态
法定名称、商号、总部或分支机构、法律性质，以及登记状态和对应日期，让您知道公司是存续、已关闭、不适格还是已暂停。
razao_socialnome_fantasiasituacao_cadastraldata_situacao_cadastralmatriz_filialnatureza_juridica经营活动、规模和税制
主要及次要 CNAE 代码、成立日期、企业规模、注册资本，以及是否选择 Simples Nacional（巴西简易税制）或 MEI（个体微型企业）。
cnae_principalcnaes_secundariosdata_inicio_atividadeporte_empresacapital_socialopcao_simplesopcao_mei地址和联系方式
经营场所的街道、门牌号、街区、邮政编码、城市和州，以及在联邦税务局登记的邮箱和电话号码。
logradourobairrocepmunicipioufemailtelefones股东及管理人员列表（QSA）
每位股东和管理人员的姓名、职务、加入日期和年龄段。自然人股东的 CPF 始终做脱敏处理。
QSAnome_socioqualificacao_sociocnpj_cpf_socio需要一次查询大量 CNPJ？CNPJ 批量查询每个请求最多支持 10,000 个，字段相同。
在文档中查看全部字段工作原理
一次 GET 调用， 无需合同。
集成方式与 CPF 查询相同，只是接口路径不同。
- 01
创建账户
在 app.cpfhub.io 自助注册，无需信用卡。API 密钥会立即显示在控制台中。
- 02
调用 GET /cnpj/{cnpj}
提交带或不带格式符号的 CNPJ，纯数字或字母数字均可，并在 x-api-key 请求头中携带密钥。查询前会先校验校验位。
- 03
使用 JSON
存储法定名称、检查登记状态或补全客户地址。未查到的 CNPJ 返回 404，不消耗积分。
支持任意编程语言集成
与 CPF 查询使用同一个密钥，路由为 /cnpj 。提供十种语言的现成示例。
# 发送 CNPJ，返回企业名称、地址和股东
curl -X GET \
'https://api.cpfhub.io/cnpj/11222333000181' \
-H 'x-api-key: YOUR_API_KEY'{
"success": true,
"data": {
"cnpj": "11222333000181",
"razao_social": "EMPRESA EXEMPLO LTDA",
"nome_fantasia": "EXEMPLO",
"situacao_cadastral": "Ativa",
"data_situacao_cadastral": "2015-03-10",
"matriz_filial": "Matriz",
"data_inicio_atividade": "2015-03-10",
"cnae_principal": "6201501",
"cnaes_secundarios": ["6204000", "6311900"],
"natureza_juridica": "Sociedade Empresária Limitada",
"logradouro": "DAS FLORES",
"numero": "100",
"bairro": "CENTRO",
"cep": "01001000",
"uf": "SP",
"municipio": "SAO PAULO",
"capital_social": "100000,00",
"porte_empresa": "Microempresa (ME)",
"opcao_simples": "S",
"opcao_mei": "N",
"QSA": [
{
"nome_socio": "FULANO DE TAL",
"cnpj_cpf_socio": "***.456.789-**",
"qualificacao_socio": "Sócio-Administrador"
}
]
}
}每月 50 个免费积分，无需信用卡。
数据来源
公开数据， 规则清晰。
您清楚自己查询的是什么，也清楚结果的适用边界。
联邦税务局开放数据
数据来自巴西联邦税务局（Receita Federal）发布的公开 CNPJ 数据集，每月更新。这不是实时查询，响应反映的是最新发布的数据集。
字母数字 CNPJ
联邦税务局自 2026 年 7 月起开始签发含字母的 CNPJ。API 已支持两种格式的校验和查询，带不带标点均可。
股东 CPF 脱敏
自然人股东的 CPF 从不完整返回。您可以获得姓名和职务，而不暴露证件号码。
应用场景
需要核验企业的 地方。
CNPJ 错误或已失效，会带来损失、发票被拒或返工。
企业客户注册
在开户、授信或发货之前，确认 CNPJ 存在且处于存续状态。
供应商准入
在签订合同或支付第一张发票之前，检查登记状态、CNAE 和股东列表。
自动填写的表单
客户输入 CNPJ，表单自动补全法定名称和地址。输入更少，错误更少。
开具发票
开票前检查地址、城市和 Simples Nacional 选择情况，避免发票被拒。
企业信用分析
成立日期、规模和注册资本，有助于区分上个月刚成立的公司和已经经营多年的公司。
AI 智能体与自动化
一个 GET 接口，JSON 结构可预期。您的智能体或自动化流程通过一次 HTTP 请求即可查询 CNPJ。
积分与状态码
只为存在的 CNPJ 付费。
成本和余额与 CPF 标准查询相同。错误、无效 CNPJ 和未查到的 CNPJ 均不消耗积分。
积分规则
- 每个查到的 CNPJ 消耗 1 个积分，与 CPF 查询共用同一余额。
- 免费版每月 50 个积分同样可用于 CNPJ。
- 未查到、无效或遇到临时故障的 CNPJ 不消耗积分。
- 速率限制与 CPF 标准查询共享：默认每分钟 30 次请求。
响应状态码
| 200 | 查到 CNPJ。消耗 1 个积分。 |
| 400 | CNPJ 格式错误或校验位错误。不消耗积分。 |
| 401 | API 密钥缺失或无效。 |
| 403 | 积分已用完或账户未激活。 |
| 404 | 数据集中未找到该 CNPJ。不消耗积分。 |
| 429 | 超出每分钟速率限制。请按 Retry-After 响应头中的时间等待。 |
| 503 | CNPJ 数据集暂时不可用。请稍后重试。不消耗积分。 |
套餐
一个余额， CPF 和 CNPJ 通用。
从每月 50 个免费积分开始，随用量增长更换套餐。
免费版
R$ 0
每月 50 个积分，无需信用卡
SLA 95%
Pro 版
R$ 19 起（巴西雷亚尔）
每月 100 至 10,000 个积分，超额用量单价 R$ 0.19 至 R$ 0.10
SLA 99%
企业版
定制价格
每月超过 10,000 个积分
SLA 99.9%
常见 问题
CNPJ 查询返回哪些数据？
法定名称、商号、登记状态及其日期、总部或分支机构、开业日期、主营和次要 CNAE 代码、法律性质、地址、电子邮箱和电话、注册资本、企业规模、Simples Nacional 和 MEI 税制选择，以及股东和管理人名单（QSA）。股东的 CPF 始终经过掩码处理。字段可能随时间增加，请忽略您的集成用不到的字段。
数据来自哪里，多久更新一次？
来自 Receita Federal（巴西联邦税务局）发布的 CNPJ 公开数据集，每月更新。CPFHub.io 不会实时查询 Receita Federal 的 CNPJ 数据：数据反映最新的月度数据集，在下次更新前可能存在滞后。
CNPJ 查询的价格是多少？
与 CPF 标准查询相同：每个查到的 CNPJ 消耗 1 个积分，使用同一套餐余额，包括免费版每月的 50 个积分。未查到（404）、无效（400）或遇到临时故障（503）的 CNPJ 不消耗积分。详见 /zh/pricing。
可以一次查询大量 CNPJ 吗？
可以。CNPJ 批量查询每次请求最多 10,000 个 CNPJ，可通过 API（POST /cnpj/bulk ）或在控制台上传 CSV 文件，只对查到的 CNPJ 计费。
API 支持字母数字 CNPJ 吗？
支持。除数字 CNPJ 外，API 还接受 Receita Federal 自 2026 年 7 月开始签发的字母数字格式（12 位字母和数字，加 2 位校验位）。可带或不带格式符号提交。
有请求频率限制吗？
有。CNPJ 查询与 CPF 标准查询共用每个 API 密钥的每分钟限制：默认每分钟 30 次请求，每个批量任务计为 1 次。超出时 API 返回 429 和 Retry-After 请求头。
不写代码能查询 CNPJ 吗？
可以。在 CPFHub.io 控制台的“查询”菜单中，CNPJ 单次查询用于逐个查询，CNPJ 批量查询用于上传列表。CPF 和 CNPJ 查询记录一并显示在“历史记录”中。