Endpoints

Buscar por nome

POST /consultas/nome módulo nome

Busca pessoas pelo nome, com filtros opcionais de cidade, UF e data de nascimento.

Corpo da requisição

Campo (JSON)	Tipo	Descrição
`nome`obrigatório	string	Nome e sobrenome (mínimo 2 caracteres).
`cidade`opcional	string	Filtra por cidade.
`uf`opcional	string	Filtra por estado (sigla de 2 letras).
`dataNascimento`opcional	string	Data de nascimento (AAAA-MM-DD).
`exato`opcional	boolean	Se true, exige correspondência exata. Padrão: false.

Requisição

Selecione a linguagem no canto do bloco — o exemplo já vem com a base URL preenchidos.

Resposta · 200

JSON

Nota

Os campos retornados são ilustrativos e variam conforme a fonte. Verifique sempre success antes de usar data.

Sem resultado · 200

Quando a fonte não encontra nada para o valor consultado, a resposta continua sendo 200, com success: false e error: "Sem resultado". Não é falha: não tente de novo, e a consulta não é cobrada nem desconta da cota.

JSON