身份核验
CNPJ 查询
按 14 位 CNPJ 查询企业官方登记信息。
GET
/openapi/v3/consultas/cnpj/{cnpj}需要
token、timestamp、sign 三个签名头，参见认证与签名。按 14 位法人税号查询工商登记：法定名称、商号、登记状态、法律性质、CNAE、注册地址、联系方式、注册资本。
响应为无包装结构，不带平台统一响应体。字段表列出全部可能字段；数据源无该项数据时字段返回空值，示例中已省略这类字段。GET 请求：签名用的 body 为空字符串，CNPJ 属于签名 path 的一部分。
路径参数
cnpj* | string | CNPJ |
* 必填字段
200
查询成功。企业登记信息。
ni | string | CNPJ |
tipoEstabelecimento | string | 机构类型 |
nomeEmpresarial | string | 法定名称 |
nomeFantasia | string | 商号 |
| object | 登记状态 |
| object | 法律性质 |
dataAbertura | string | 开业日期 |
| object | 主营活动 CNAE |
| object | 注册地址 |
| object | 税务管辖市镇 |
| array | 联系电话 |
correioEletronico | string | 电子邮箱 |
capitalSocial | number | 注册资本 |
porte | string | 企业规模码 |
situacaoEspecial | string | 特殊状态 |
dataSituacaoEspecial | string | 特殊状态生效日期 |
格式与校验位错误（10016010、10016011）由平台本地拦截，不消耗调用额度也不计费。鉴权层错误（401 / 403 / 429）为平台统一响应体格式；错误模型见 身份核验。
tipoEstabelecimento机构类型
| 取值 | 含义 |
|---|---|
| 1 | 总部 |
| 2 | 分支机构 |
situacaoCadastral.codigo登记状态码
| 取值 | 含义 |
|---|---|
| 1 | 无效 |
| 2 | 正常营业 |
| 3 | 已暂停 |
| 4 | 不适格 |
| 8 | 已注销 |
| 错误码 | HTTP | |
|---|---|---|
| 10016010 | 400 | CNPJ 格式不合法（须 14 位数字）。检查是否误传格式符。 |
| 10016011 | 400 | CNPJ 校验位不合法。本地先用 mod-11 算法校验。 |
| 10016012 | 400 | 未找到该 CNPJ 的信息：官方登记中不存在。 |
| 10016020 | 503 | 上游数据源暂不可用。退避重试（初始 1 秒，倍增至 30 秒上限，加抖动）；持续出现请联系平台。 |