API de consulta por nome
O endpoint de nome recebe um nome completo (mínimo dois termos) e retorna uma lista paginada de registros candidatos, com indicadores de qualidade para desambiguação. É usado para conciliação cadastral e validação de titularidade em processos autorizados — não para vigilância pessoal.
Para que serve
- Conciliação cadastral: encontrar o registro correto por nome + outros dados.
- Validação de titularidade em processos autorizados.
- Desambiguação de homônimos com apoio dos indicadores de confiança.
Requisição
Autentique com o header Authorization: Bearer — gere seu token no dashboard após ativar um plano.
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/nome" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"nome":"Nome Completo do Titular"}'const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/nome", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({"nome":"Nome Completo do Titular"}),
});
const data = await res.json();<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/nome");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => '{"nome":"Nome Completo do Titular"}',
]);
$data = json_decode(curl_exec($ch), true);Resposta (200)
Exemplo com valores ilustrativos. O nível de detalhe (dados completos ou mascarados) depende do seu plano.
{
"success": true,
"tipo_consulta": "nome",
"query": {
"termo_mascarado": "N*** C*** do T***",
"finalidade": "conciliacao_cadastral"
},
"resultado_count": 2,
"data_quality": {
"sources_used": 2,
"confidence_score": 78
},
"data": [
{
"identificacao": {
"nome": "NOME COMPLETO DO TITULAR",
"documento": "123.***.**9-09",
"data_nascimento": "1988-05-12"
},
"localizacao": {
"cidade": "Curitiba",
"estado": "PR"
}
},
{
"identificacao": {
"nome": "NOME COMPLETO DO TITULAR",
"documento": "987.***.**1-00",
"data_nascimento": "1995-11-03"
},
"localizacao": {
"cidade": "Recife",
"estado": "PE"
}
}
],
"audit": {
"logged": true,
"timestamp": "2026-07-01T12:00:00.000Z"
},
"message": "Consulta realizada com sucesso."
}Campos retornados
| Campo | Descrição |
|---|---|
| resultado_count | Total de registros encontrados para o nome. |
| data[].identificacao | Nome, documento e data de nascimento de cada candidato. |
| data[].localizacao | Cidade/UF de cada candidato para desambiguação. |
| data_quality | confidence_score por resultado. |
Perguntas frequentes
Preciso informar o nome completo?
Sim. São exigidos ao menos dois termos (nome e sobrenome). Nomes com um único termo retornam erro de validação.
Há paginação?
Sim. Os parâmetros pagina (padrão 1) e limite (padrão 20, máximo 50) controlam a página e o tamanho do lote.
Como diferenciar homônimos?
Use os campos de localização, data de nascimento e o confidence_score de cada resultado para cruzar com o dado que você já possui e identificar o registro correto.
Endpoints relacionados
Integre consulta por nome hoje
Ative um plano a partir de R$ 10, gere seu token Bearer e comece a consultar em minutos. Consultas ilimitadas enquanto o plano estiver ativo.