身份核验
CPF 查询
按 CPF 与出生日期查询自然人官方登记信息。
/openapi/v3/consultas/cpf/{cpf}/{nascimento}需要 token、timestamp、sign 三个签名头，参见认证与签名。
按 11 位自然人税号 加出生日期查登记信息：姓名、登记状态、出生日期。上游按 CPF 与出生日期配对核验；配对不符与查无此人返回同一个错误码 10016003，刻意不作区分（见 身份核验）。
GET 请求：签名用的 body 为空字符串，两个路径变量都属于签名 path 的一部分。响应为裸结构，不带平台信封。
参数
路径参数
cpfstring必填11 位纯数字，不接受格式符。
示例:40710536828nascimentostring必填出生日期，DDMMYYYY 八位数字（如
09011997表示 1997 年 1 月 9 日）。示例:09011997
响应
查询成功，持有人已成年。自然人登记信息。
nistringCPF 纯数字（11 位）。
nomestring自然人姓名。
situacaoobject登记状态。
nascimentostring出生日期，DDMMYYYY 原格式回显。
错误
| 错误码 | HTTP | |
|---|---|---|
| 10016000 | 400 | CPF 格式不合法（须 11 位数字）。检查是否误传格式符或位数不足。 |
| 10016001 | 400 | CPF 校验位不合法。本地先用 mod-11 算法校验，避免无效调用。 |
| 10016002 | 400 | 出生日期格式不合法（须 DDMMYYYY 有效日期）。注意是日月年顺序，且须为真实存在的日期。 |
| 10016003 | 400 | 未找到该 CPF 的信息：该 CPF 不存在，或 CPF 与出生日期不匹配（二者不作区分）。按次计费。 |
| 10016005 | 422 |
|
| 10016004 | 451 |
|
| 10016006 | 428 |
|
| 10016020 | 503 | 上游数据源暂不可用。退避重试（初始 1 秒，倍增至 30 秒上限，加抖动）；持续出现请联系平台。不计费。 |
situacao.codigo 取值
| 码 | 描述 | 含义 |
|---|---|---|
0 | REGULAR | 正常 |
2 | SUSPENSA | 已暂停 |
3 | TITULAR FALECIDO | 持证人已故 |
4 | PENDENTE DE REGULARIZACAO | 待补正 |
5 | CANCELADA POR MULTIPLICIDADE | 因重复注销 |
8 | NULA | 无效 |
9 | CANCELADA DE OFICIO | 依职权注销 |
业务提醒：
codigo非0时应由调用方决定是否继续业务流程。例如向已故持证人（3）开票在业务上通常需要拦截，本接口仅如实透传状态，不代做业务判断。
未成年人与年龄核实（LGPD / Lei Felca）
上游数据源按持有人年龄分档应答，平台原状态码透传、不做二次加工：
| 年龄核实结果 | HTTP | code | 响应 |
|---|---|---|---|
| 成年（18 岁及以上） | 200 | （无） | 正常返回姓名、登记状态、出生日期 |
| 16 到 17 岁 | 422 | 10016005 | { "code": 10016005, "message": "LGPD: menor de idade" }，不含任何人员字段 |
| 小于 16 岁 | 451 | 10016004 | { "code": 10016004, "message": "LGPD: menor de 16 anos (Lei Felca)" }，不含任何人员字段 |
| 年龄无法核实 | 428 | 10016006 | { "code": 10016006, "message": "LGPD: idade nao verificavel - informe a data de nascimento para completar a verificacao" }，不含任何人员字段 |
- 三档拦截的
message是上游给定的法定文案（葡语原文），不随Language头翻译；程序判断请用code。 - 428 表示上游库内缺少该持有人的出生日期、算不出年龄。平台已用你传入的出生日期向上游补核验一次（在同一次调用内完成，不需要你重试）：核验通过按上表正常返回；仍返回 428 说明官方来源也无法核实，重试无意义。
- 计费口径：422（16 到 17 岁）、451（小于 16 岁）与查无 / 出生日期不配对（400 +
10016003）按次计费，上游数据源对这三种结论同样收费；428（年龄无法核实）与上游不可用（503）不计费。平台对三档拦截不留存任何结果。收到 422 / 451 时请勿对同一 CPF 反复查询：年龄不会因为重试而变化，且每次都会计费。 - 格式与校验位错误由平台本地拦截，不发往上游数据源，不计费。