Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
Permite validar identidades de cidadãos e residentes do México consultando informações na base oficial de registro poblacional. O serviço verifica a Clave Única de Registro de Población (CURP) contra os dados governamentais, garantindo autenticidade e precisão dos registros cadastrais.
Ideal para fluxos que exigem confirmação de identidade com segurança elevada, como onboarding de clientes e fornecedores, análise de risco e compliance. Reduz custos operacionais ao eliminar consultas manuais e erros de digitação, além de aumentar a confiabilidade das decisões tomadas sobre os dados validados.
O endpoint retorna os seguintes campos sobre o indivíduo consultado:
name — Nome completo registrado
dateOfBirth — Data de nascimento (formato DD/MM/YYYY)
age — Idade calculada
gender — Gênero do registro
nationality — Nacionalidade informada
placeOfBirth — Local de nascimento
city — Cidade do registro
state — Unidade federativa
curp — CURP normalizado
A resposta inclui também metadados da operação, como identificador único da consulta, timestamp de execução e tempo de processamento.
Schema da resposta (JSON Schema)
JSON Schema
{
"type": "object",
"properties": {
"retorno": {
"type": [
"object",
"null"
],
"properties": {
"age": {
"type": [
"integer",
"null"
],
"description": "Idade do indivíduo."
},
"city": {
"type": [
"string",
"null"
],
"description": "Cidade do registro."
},
"curp": {
"type": [
"string",
"null"
],
"description": "Clave Única de Registro de Población (código exclusivo de registro populacional)."
},
"name": {
"type": [
"string",
"null"
],
"description": "Nome do indivíduo/registro."
},
"state": {
"type": [
"string",
"null"
],
"description": "Estado do registro."
},
"gender": {
"type": [
"string",
"null"
],
"description": "Gênero do indivíduo."
},
"dateOfBirth": {
"type": [
"string",
"null"
],
"description": "Data de nascimento."
},
"nationality": {
"type": [
"string",
"null"
],
"description": "Nacionalidade do indivíduo."
},
"placeOfBirth": {
"type": [
"string",
"null"
],
"description": "Local de nascimento."
}
},
"description": "Dados do resultado da consulta."
},
"metaDados": {
"type": [
"object",
"null"
],
"properties": {
"ip": {
"type": [
"string",
"null"
],
"description": "Endereço IP da requisição."
},
"data": {
"type": [
"string",
"null"
],
"description": "Data e hora da consulta."
},
"chave": {
"type": [
"string",
"null"
],
"description": "Chave de identificação."
},
"usuario": {
"type": [
"string",
"null"
],
"description": "Usuário que realizou a consulta."
},
"mensagem": {
"type": [
"string",
"null"
],
"description": "Mensagem de resposta."
},
"apiVersao": {
"type": [
"string",
"null"
],
"description": "Versão da API."
},
"resultado": {
"type": [
"string",
"null"
],
"description": "Status do resultado."
},
"assincrono": {
"type": [
"boolean",
"null"
],
"description": "Indica se a consulta é assíncrona."
},
"consultaUid": {
"type": [
"string",
"null"
],
"description": "Identificador único da consulta."
},
"resultadoId": {
"type": [
"integer",
"null"
],
"description": "ID do resultado."
},
"consultaNome": {
"type": [
"string",
"null"
],
"description": "Nome da consulta realizada."
},
"enviarCallback": {
"type": [
"boolean",
"null"
],
"description": "Indica se deve enviar callback."
},
"urlComprovante": {
"type": [
"string",
"null"
],
"description": "URL do comprovante gerado."
},
"tempoExecucaoMs": {
"type": [
"integer",
"null"
],
"description": "Tempo de execução em milissegundos."
},
"gerarComprovante": {
"type": [
"boolean",
"null"
],
"description": "Indica se deve gerar comprovante."
}
},
"description": "Metadados da consulta."
}
}
}
Códigos de erro
Código
Mensagem
Quando acontece
400
Requisição Inválida
a requisição está incorreta ou os parâmetros são inválidos.
401
Não Autenticado
o usuário não forneceu as credenciais corretas para acessar o recurso.
403
Não Autorizado
o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404
Não Encontrado
o servidor não encontrou uma representação atual do recurso solicitado.
408
Tempo Esgotado
o servidor não conseguiu retornar a requisição no prazo estabelecido.
500
Falha ao Realizar Consulta
o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503
Consulta em Manutenção
a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.
Observações
Comprovantes em PDF
O serviço permite gerar um comprovante em PDF da consulta realizada, útil para auditoria e documentação de processos de due diligence. O comprovante contém todos os dados validados e pode ser armazenado como prova do procedimento.
Validação de Formato
A CURP não necessita estar previamente formatada. O gateway normaliza automaticamente o parâmetro antes da consulta, aceitando tanto formato compacto quanto com separadores.
Casos de Uso Recomendados
Validação durante onboarding de clientes e fornecedores
Verificação em processos de análise de risco e concessão de crédito
Conformidade com requisitos de KYC (Know Your Customer)
Automação de decisões operacionais que dependem de identidade verificada
Integrar
OpenAPI (JSON) ↗ — importe a URL
no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar
pelo chat: conecte via MCP. Esta página em Markdown.