# Registro Nacional de Población - CURP

> Valida identidades de cidadãos mexicanos consultando a CURP na base governamental do RENAPO com máxima segurança, garantindo precisão para KYC e automação de cadastros.

- **Consulta:** `curp-mexico`
- **Categoria:** Internacional
- **Preço:** R$ 0,51 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/curp-mexico`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/internacional/curp-mexico

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/curp-mexico?curp=SEU_CURP"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/curp-mexico",
    params={"curp": "SEU_CURP"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/curp-mexico");

url.search = new URLSearchParams({
  "curp": "SEU_CURP"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `curp` | texto | sim | CURP mexicano (18 caracteres) | formato: 18 caracteres |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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
{
  "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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> **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

---

Página em HTML: https://fontedata.com/docs/internacional/curp-mexico
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp