# Validação de Similaridade - México

> Compara dados do CURP fornecidos com registros na base, validando inconsistências em atributos como nome, endereço e informações pessoais. Detecta discrepâncias para garantir integridade dos dados cad

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Valida e compara os dados cadastrais fornecidos de um indivíduo no México contra registros existentes. Especificamente, realiza a verificação da integridade das informações do Código de Registro de População Única Mexicano (CURP) e dados associados, identificando inconsistências ou divergências em atributos como nome, sobrenome, data de nascimento, endereço e informações de contato.
>
> Esse serviço é especialmente útil em fluxos de onboarding de clientes, validação de identidade, prevenção de fraudes e qualificação de leads, permitindo que aplicações detectem possíveis erros de digitação, dados desatualizados ou informações incompatíveis antes de prosseguir com etapas críticas do processo.

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/similarity-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/similarity-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.
>
> A resposta retorna metadados da consulta (identificadores, timestamp, tempo de execução) e um objeto `retorno` contendo:
>
> - **`curp`** — Código informado/identificado, descrição do registro encontrado e distância (grau de similaridade)
> - **`name`** — Nome recuperado, descrição associada e medida de distância
> - **`dob`** — Data de nascimento registrada, descrição e distância
> - **`address`** — Endereço encontrado, descrição e distância
> - **`city`** — Cidade associada, descrição e distância
> - **`state`** — Estado registrado, descrição e distância
> - **`postCode`** — Código postal com análise separada dos primeiros cinco dígitos
> - **`phone`** — Lista de telefones vinculados com respectivas descrições e distâncias
>
> O campo **`distance`** representa numericamente o grau de correspondência entre o valor enviado e o registrado (valores menores indicam maior similaridade).

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "retorno": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "dob": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "dob": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data de nascimento fornecida ou localizada."
            },
            "distance": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância entre a data de nascimento fornecida e registrada."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos dados de data de nascimento."
            }
          },
          "description": "Validação da data de nascimento."
        },
        "city": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "city": {
              "type": [
                "string",
                "null"
              ],
              "description": "Cidade fornecida ou localizada."
            },
            "distance": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância entre a cidade fornecida e registrada."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos dados de cidade."
            }
          },
          "description": "Validação da cidade."
        },
        "curp": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "curp": {
              "type": [
                "string",
                "null"
              ],
              "description": "CURP fornecido ou localizado."
            },
            "distance": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância entre o CURP fornecido e registrado."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos dados de CURP."
            }
          },
          "description": "Validação do CURP."
        },
        "name": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ],
              "description": "Nome fornecido ou localizado."
            },
            "distance": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância entre o nome fornecido e registrado."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos dados de nome."
            }
          },
          "description": "Validação do nome."
        },
        "phone": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "phone": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Número de telefone."
              },
              "distance": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Distância entre o telefone fornecido e registrado."
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Descrição dos dados de telefone."
              }
            }
          },
          "description": "Lista de telefones validados."
        },
        "state": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "state": {
              "type": [
                "string",
                "null"
              ],
              "description": "Estado fornecido ou localizado."
            },
            "distance": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância entre o estado fornecido e registrado."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos dados de estado."
            }
          },
          "description": "Validação do estado."
        },
        "address": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "address": {
              "type": [
                "string",
                "null"
              ],
              "description": "Endereço fornecido ou localizado."
            },
            "distance": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância entre o endereço fornecido e registrado."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos dados de endereço."
            }
          },
          "description": "Validação do endereço."
        },
        "postCode": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "distance": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância entre o código postal fornecido e registrado."
            },
            "postCode": {
              "type": [
                "string",
                "null"
              ],
              "description": "Código postal fornecido ou localizado."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos dados de código postal."
            },
            "distanceOnFirstFiveDigits": {
              "type": [
                "number",
                "null"
              ],
              "description": "Distância nos primeiros cinco dígitos do código postal."
            },
            "descriptionOnFirstFiveDigits": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição dos primeiros cinco dígitos do código postal."
            }
          },
          "description": "Validação do código postal."
        }
      },
      "description": "Resultado da validação de similaridade."
    },
    "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 realizada."
        },
        "enviarCallback": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se um callback será enviado."
        },
        "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."
    }
  }
}
```

## 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.
>
> - Envie apenas um documento por requisição
> - A análise é realizada de forma síncrona; a resposta é retornada imediatamente
> - Campos opcionais podem ser omitidos quando não disponíveis. A presença de mais dados melhora a acurácia da validação
> - Em caso de dúvidas ou necessidade de suporte técnico, consulte a equipe de atendimento
> - Recomenda-se validar dados cadastrais durante processos de onboarding e periodicamente para manter registros atualizados

---

Página em HTML: https://fontedata.com/docs/internacional/similarity-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