Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
Recupera informações cadastrais de pessoas físicas registradas no México através do CURP (Clave Única de Registro de Población). O serviço é ideal para processos de validação de identidade, verificação de dados pessoais e consultas operacionais que requerem informações atualizadas e confiáveis.
Casos de uso:
Validação e confirmação de dados cadastrais durante onboarding de clientes
Análise de risco e tomada de decisão em operações creditícias
Verificação de conformidade regulatória e compliance
Automação de fluxos que dependem de dados pessoais validados
Suporte em processos de risco operacional e ESG
Benefícios:
Reduz erros manuais de digitação e inconsistências de dados
Melhora a confiabilidade das decisões baseadas em informações cadastrais
Oferece integração simples e escalável em sistemas existentes
A resposta inclui também metadados sobre a consulta realizada (identificador único, timestamp de execução, versão da API e status de processamento).
Schema da resposta (JSON Schema)
JSON Schema
{
"type": "object",
"properties": {
"retorno": {
"type": [
"object",
"null"
],
"properties": {
"age": {
"type": [
"number",
"null"
],
"description": "Idade do indivíduo."
},
"rfc": {
"type": [
"string",
"null"
],
"description": "Registro Federal de Contribuintes do México."
},
"curp": {
"type": [
"string",
"null"
],
"description": "Código de Registro de População Única do México."
},
"name": {
"type": [
"string",
"null"
],
"description": "Nome completo do indivíduo."
},
"emails": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"emailAddress": {
"type": [
"string",
"null"
],
"description": "Endereço de e-mail."
}
}
},
"description": "Lista de endereços de e-mail vinculados ao indivíduo."
},
"gender": {
"type": [
"string",
"null"
],
"description": "Gênero do indivíduo."
},
"phones": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"phoneType": {
"type": [
"string",
"null"
],
"description": "Tipo de telefone."
},
"phoneNumber": {
"type": [
"string",
"null"
],
"description": "Número de telefone."
}
}
},
"description": "Lista de telefones vinculados ao indivíduo."
},
"addresses": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
],
"description": "Cidade do endereço."
},
"state": {
"type": [
"string",
"null"
],
"description": "Estado do endereço."
},
"number": {
"type": [
"string",
"null"
],
"description": "Número do endereço."
},
"street": {
"type": [
"string",
"null"
],
"description": "Nome da rua."
},
"complement": {
"type": [
"string",
"null"
],
"description": "Complemento do endereço."
},
"postalCode": {
"type": [
"string",
"null"
],
"description": "Código postal do endereço."
},
"neighborhood": {
"type": [
"string",
"null"
],
"description": "Bairro do endereço."
}
}
},
"description": "Lista de endereços do indivíduo."
},
"dateOfBirth": {
"type": [
"string",
"null"
],
"description": "Data de nascimento do indivíduo."
},
"salaryRange": {
"type": [
"string",
"null"
],
"description": "Faixa salarial estimada."
},
"estimatedSalary": {
"type": [
"string",
"null"
],
"description": "Salário estimado."
}
},
"description": "Dados cadastrais retornados 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 associada à consulta."
},
"usuario": {
"type": [
"string",
"null"
],
"description": "Usuário que realizou a consulta."
},
"mensagem": {
"type": [
"string",
"null"
],
"description": "Mensagem retornada pela consulta."
},
"apiVersao": {
"type": [
"string",
"null"
],
"description": "Versão da API utilizada."
},
"resultado": {
"type": [
"string",
"null"
],
"description": "Status do resultado da consulta."
},
"assincrono": {
"type": [
"boolean",
"null"
],
"description": "Indica se a consulta foi executada de forma assíncrona."
},
"consultaUid": {
"type": [
"string",
"null"
],
"description": "Identificador único da consulta."
},
"resultadoId": {
"type": [
"number",
"null"
],
"description": "Identificador numérico do resultado."
},
"consultaNome": {
"type": [
"string",
"null"
],
"description": "Nome da consulta executada."
},
"enviarCallback": {
"type": [
"boolean",
"null"
],
"description": "Indica se a consulta será enviada por callback."
},
"urlComprovante": {
"type": [
"string",
"null"
],
"description": "URL do comprovante gerado."
},
"tempoExecucaoMs": {
"type": [
"number",
"null"
],
"description": "Tempo de execução da consulta em milissegundos."
},
"gerarComprovante": {
"type": [
"boolean",
"null"
],
"description": "Indica se um comprovante será gerado."
}
},
"description": "Metadados da consulta realizada."
}
}
}
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
A consulta retorna dados cadastrais validados e estruturados, ideal para processos que exigem informações confiáveis
O CURP pode ser fornecido com ou sem formatação
Esta consulta não gera comprovantes ou documentos adicionais
Em caso de dúvidas, consulte a documentação técnica do gateway ou contate o suporte
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.