CNPJ 查询

发送 CNPJ（巴西企业税号），即可获取企业登记数据：法定名称、商业名称、登记状态、地址、CNAE（经营活动代码）、企业规模、Simples Nacional/MEI（巴西简易税制/个体微型企业）和 股东及管理人（QSA）。每查到一个 CNPJ 消耗 1 个积分，与 CPF 标准查询相同。

正在使用 Cursor、Lovable、v0 或其他 AI 工具？复制 CNPJ 查询的提示词，粘贴到您的 AI 助手中。

在 Cursor 中打开

正在使用 Cursor、Lovable、v0 或其他 AI 工具？复制 CNPJ 查询的提示词，粘贴到您的 AI 助手中。

在 Cursor 中打开

需要一次查询多个 CNPJ？请使用 CNPJ 批量查询。如果不想写代码，可以在控制台逐个查询 CNPJ，结果会保存在“历史记录”中。

端点

GEThttps://api.cpfhub.io/cnpj/{cnpj}

参数

位置	名称	必填	说明
路径	`cnpj`	是	带或不带格式的 CNPJ：`11222333000181` 或 `11.222.333/0001-81`。支持字母数字 CNPJ（见下文）。
请求头	`x-api-key`	是	您的 API 密钥。见身份认证。

字母数字 CNPJ

API 支持新的字母数字 CNPJ 格式。Receita Federal（巴西联邦税务局）自 2026 年 7 月起开始签发此格式：12 个由字母（A 到 Z）和数字组成的字符，后接 2 位数字校验位。虚构示例：12ABC34501DE35（或 12.ABC.345/01DE-35）。

小写字母会被转换为大写。
校验前会去除点、斜杠和连字符。
两种格式都会校验校验位。00000000000000 这类重复序列会被拒绝。
请在数据库中以文本形式保存 CNPJ，不要存为数字。

示例

示例从 CPFHUB_API_KEY 读取密钥，将 404 视为正常结果，并设置 10 秒超时。

curl --max-time 10 "https://api.cpfhub.io/cnpj/11222333000181" \
  -H "x-api-key: $CPFHUB_API_KEY"

响应

HTTP 200 OK

JSON

{
  "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"],
    "codigo_natureza_juridica": "2062",
    "natureza_juridica": "Sociedade Empresária Limitada",
    "tipo_logradouro": "RUA",
    "logradouro": "DAS FLORES",
    "numero": "100",
    "complemento": "SALA 1",
    "bairro": "CENTRO",
    "cep": "01001000",
    "uf": "SP",
    "municipio": "SAO PAULO",
    "email": "contato@example.com",
    "telefones": [
      { "ddd": "11", "numero": "00000000", "is_fax": false }
    ],
    "capital_social": "100000,00",
    "porte_empresa": "Microempresa (ME)",
    "opcao_simples": "S",
    "data_opcao_simples": "2015-03-10",
    "opcao_mei": "N",
    "data_opcao_mei": null,
    "QSA": [
      {
        "nome_socio": "FULANO DE TAL",
        "cnpj_cpf_socio": "***.456.789-**",
        "qualificacao_socio": "Sócio-Administrador",
        "data_entrada_sociedade": "2015-03-10",
        "identificador_socio": "Pessoa Física",
        "faixa_etaria": "31 a 40 anos"
      }
    ]
  }
}

字段来自 CNPJ 公开数据库，因此字段名和取值均为葡萄牙语，类型大多为 string。日期格式为 YYYY-MM-DD。空字段可能返回 ""。

字段	类型	说明
`data.cnpj`	`string`	查询的 CNPJ，14 个字符，不带格式
`data.razao_social`	`string`	法定名称
`data.nome_fantasia`	`string`	商业名称。可能为空
`data.situacao_cadastral`	`string`	登记状态：`"Ativa"`（存续）、`"Baixada"`（已注销）、`"Inapta"`（不适格）、`"Suspensa"`（已暂停）或 `"Nula"`（无效）
`data.data_situacao_cadastral`	`string` \| `null`	当前登记状态的日期
`data.matriz_filial`	`string`	`"Matriz"`（总部）或 `"Filial"`（分支机构）
`data.data_inicio_atividade`	`string` \| `null`	成立日期
`data.cnae_principal`	`string`	主要 CNAE，7 位数字
`data.cnaes_secundarios`	`string[]`	次要 CNAE，每个 7 位数字
`data.codigo_natureza_juridica`, `data.natureza_juridica`	`string`	法律性质的代码（4 位数字）和说明
`data.tipo_logradouro`, `data.logradouro`, `data.numero`, `data.complemento`, `data.bairro`	`string`	经营场所地址
`data.cep`	`string`	邮政编码（CEP），8 位数字，不带格式
`data.uf`, `data.municipio`	`string`	州（缩写）和城市
`data.email`	`string`	在 Receita Federal 登记的电子邮箱。可能为空
`data.telefones[]`	`object[]`	`ddd`（区号）、`numero` 和 `is_fax`（`boolean`）
`data.capital_social`	`string`	注册资本，以逗号作小数点：`"100000,00"`
`data.porte_empresa`	`string`	企业规模：`"Microempresa (ME)"`、`"Empresa de Pequeno Porte (EPP)"`、`"Demais"` 或 `"Não informado"`
`data.opcao_simples`, `data.opcao_mei`	`string`	`"S"`（是）、`"N"`（否）或 `""`（无信息）
`data.data_opcao_simples`, `data.data_opcao_mei`	`string` \| `null`	企业选择加入 Simples Nacional 和 MEI 的日期
`data.QSA[]`	`object[]`	股东及管理人（见下文）
`data.lgpd_anonimizado`	`boolean`	仅在数据主体申请匿名化时出现。部分字段会被隐藏

data.QSA 中的每一项：

字段	说明
`nome_socio`	股东名称（个人或企业）
`cnpj_cpf_socio`	企业股东的 CNPJ。个人股东的 CPF 始终脱敏：`*.456.789-`
`qualificacao_socio`	职务，例如 `"Sócio-Administrador"`（管理合伙人）
`data_entrada_sociedade`	股东加入日期，或 `null`
`identificador_socio`	`"Pessoa Física"`（个人）、`"Pessoa Jurídica"`（企业）或 `"Estrangeiro"`（外国人）
`faixa_etaria`	股东年龄段

源数据库中为空或为 0000-00-00 的日期返回 null。
响应可能新增字段。请忽略代码无法识别的字段。

错误

API 只返回葡萄牙语信息。错误信息按原样列出，括号内为中文释义。

状态码	触发场景	处理方式
`400`	CNPJ 格式无效或校验位错误（`"CNPJ inválido. Formato ou dígito verificador incorreto."`，CNPJ 无效）	修正 CNPJ。不要重试。不消耗积分。
`401`	API 密钥缺失、无效或已停用（`error` 为字符串）	检查 `x-api-key` 请求头。
`403`	积分已用完且未开通超额用量（`"Limite de créditos excedido"`，积分额度已超出，`error` 通常为字符串，有时在 `error.message` 中），或账户已停用/封禁（`error` 为字符串）	补充积分或联系支持团队。不要重试。
`404`	数据库中没有该 CNPJ（`"CNPJ não encontrado na base de dados"`）	正常结果。不消耗积分。
`429`	超出每分钟限制，与 CPF 标准查询共用（默认 30 次/分钟）	等待 `Retry-After` 请求头给出的秒数。不消耗积分。
`503`	CNPJ 数据库不可用（`"cnpj_unavailable"`），或在预留积分、保存查询记录时出现临时故障	按递增间隔重试（2 秒、4 秒、8 秒）。不消耗积分。

错误格式和重试策略见错误码。每分钟限制和积分规则见使用限制。

补充说明

费用： 每查到一个 CNPJ（200）消耗 1 个积分，与 CPF 标准查询费用相同，从同一套餐额度中扣除。部分套餐有单独的费用，请在控制台查看。400、404、429 和 503 不消耗积分。
每分钟限制： CNPJ 查询和 CPF 标准查询按 API 密钥共用同一限制（默认两者合计每分钟 30 次请求）。
数据来源： Receita Federal 发布的 CNPJ 公开数据库（Dados Abertos do CNPJ），每月更新，由 OpenCNPJ 项目（MIT 许可证）处理。CPFHub.io 查询 CNPJ 时不会实时访问 Receita Federal，因此在下一次月度更新前，记录可能不是最新的。CNPJ 不提供实时查询。
个人股东： 股东的 CPF 始终脱敏。API 不会返回股东的完整 CPF。
历史记录： CNPJ 查询会与 CPF 查询一起显示在控制台的“历史记录”中。
客户端超时： 查询可能已在服务器端完成并计费。重试会再次计费。
示例数据： CNPJ 11222333000181、字母数字 CNPJ 12ABC34501DE35 及上方数据均为虚构。

更新于 2026 年 10 月 15 日