CPF 验证
通过 API 验证巴西 CPF 号码（登记数据）
本地校验位计算无法证明身份。CPFHub.io 接收 CPF，返回姓名、性别和出生日期，供您在业务流程中比对。
校验位计算与数据查询
模 11 算法只校验数字。数据查询返回姓名、性别和出生日期，供您的后端比对。
比对在您的后端完成
比对规则（姓名、出生日期）保留在您的系统中。API 只负责提供数据。
登记状态请用另一接口
本接口返回姓名、性别和出生日期。如需登记状态，请使用实时查询（/zh/cpf-lookup-federal-revenue），需提供持有人的出生日期。
免费版：50 次测试
免费版每月 50 个积分，无需信用卡。Pro 版每月 R$ 19（巴西雷亚尔）起，含 100 个积分。
示例
一次 GET 请求，返回完整 JSON
使用 x-api-key 请求头。Base URL 为 https://api.cpfhub.io ，URL 中不含版本号。
curl -X GET \
'https://api.cpfhub.io/cpf/12345678909' \
-H 'x-api-key: YOUR_API_KEY'{
"success": true,
"data": {
"cpf": "12345678909",
"name": "Fulano de Tal",
"nameUpper": "FULANO DE TAL",
"gender": "M",
"birthDate": "15/06/1990",
"day": 15,
"month": 6,
"year": 1990
}
}常见问题
常见 问题
验证 CPF 和查询 Receita Federal 是一回事吗？
在本接口上不是。GET /cpf/{cpf} 从我们的数据库返回姓名、性别和出生日期，供您在流程中比对。如果您掌握持有人的出生日期，并需要登记状态或死亡年份，可使用实时查询。它实时查询 Receita Federal（巴西联邦税务局），返回登记状态、deathYear 和凭证（每次成功查询 1.5 个积分）。详见 /zh/cpf-lookup-federal-revenue。
你们提供 KYC 吗？
本接口不提供。不含自拍、证件 OCR、人脸比对或生物识别。CPF 查询返回的是登记数据，验证规则（比对）保留在您的后端。
JSON 中包含哪些内容？
查到的 CPF 返回：cpf（11 位数字，无格式符号）、name、nameUpper、gender（M/F）、birthDate，以及 day、month、year。身份认证：x-api-key 请求头。基础地址：https://api.cpfhub.io 。
还有疑问？
联系我们