Skip to main content
POST
https://localapi.lazydata.com.br
/
v1
/
search
/
person
/
advanced
Busca avançada
curl --request POST \
  --url https://localapi.lazydata.com.br/v1/search/person/advanced \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "mother_name": "<string>",
  "father_name": "<string>",
  "identity_card": "<string>",
  "pis": "<string>",
  "voter_registration": "<string>",
  "zipcode": "<string>",
  "page": 123
}
'
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "items": [
      {
        "taxid": "00000000000",
        "name": "CARLOS SANTOS SILVA",
        "birthdate": "1978-05-17",
        "age": 48,
        "mother_name": "MARIA SANTOS SILVA",
        "father_name": "JOSE SILVA",
        "location": "Rio de Janeiro/RJ",
        "city": "Rio de Janeiro",
        "state": "RJ",
        "synthetic": true
      }
    ],
    "has_more": false,
    "page": 1,
    "price": 0.09,
    "charged": 0.09,
    "debit_only_if_found": false,
    "time": 0.42,
    "test": false
  }
}
Executa uma busca avançada de pessoa física em formato paginado. Use esta rota quando você não possui o CPF da pessoa, mas possui dados como nome completo, nome completo da mãe, nome completo do pai, RG, PIS, título de eleitor ou CEP. 
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "items": [
      {
        "taxid": "00000000000",
        "name": "CARLOS SANTOS SILVA",
        "birthdate": "1978-05-17",
        "age": 48,
        "mother_name": "MARIA SANTOS SILVA",
        "father_name": "JOSE SILVA",
        "location": "Rio de Janeiro/RJ",
        "city": "Rio de Janeiro",
        "state": "RJ",
        "synthetic": true
      }
    ],
    "has_more": false,
    "page": 1,
    "price": 0.09,
    "charged": 0.09,
    "debit_only_if_found": false,
    "time": 0.42,
    "test": false
  }
}

​
Corpo da requisição

​
name
string
Nome completo da pessoa. Quando informado, deve conter ao menos nome e sobrenome.
​
mother_name
string
Nome completo da mãe. Pode ser usado sem informar o nome da pessoa.
​
father_name
string
Nome completo do pai. Pode ser usado sem informar o nome da pessoa.
​
identity_card
string
Número do RG. Pontuação é aceita e removida automaticamente.
​
pis
string
Número do PIS. Pontuação é aceita e removida automaticamente.
​
voter_registration
string
Número do título de eleitor. Pontuação é aceita e removida automaticamente.
​
zipcode
string
CEP com 8 dígitos. Pontuação é aceita e removida automaticamente.
​
page
integer
default:"1"
Página dos resultados. Use a próxima página enquanto has_more for true.
​
x-ambient
string
Use sandbox para executar uma chamada de teste sem consumo de saldo.
Para detalhes sobre chamadas de teste, consulte /quickstart/sandbox.

​
Regras dos filtros

É necessário informar pelo menos um dos campos aceitos. Nomes informados em name, mother_name e father_name devem ser completos. A busca normaliza os nomes internamente para letras maiúsculas, remove acentos e padroniza espaços antes de consultar o índice. Campos numéricos como identity_card, pis, voter_registration e zipcode aceitam pontuação, mas são consultados apenas com dígitos.

​
Exemplo de corpo

{
  "name": "CARLOS SANTOS SILVA",
  "mother_name": "MARIA SANTOS SILVA",
  "zipcode": "01001000",
  "page": 1
}

​
Resposta

​
code
integer
required
Código da resposta da API.
​
message
string
required
Mensagem descritiva da resposta.
​
result
object
required
Objeto principal com os registros encontrados, dados de paginação, cobrança e tempo de execução.

​
Estrutura de result

CampoTipoDescrição
itemsarray<object>Registros encontrados para os filtros enviados.
has_morebooleanIndica se existe próxima página disponível.
pageintegerPágina retornada.
pricenumberPreço da busca para a conta autenticada.
chargednumberValor debitado nesta chamada. Em sandbox, retorna 0.
debit_only_if_foundbooleanIndica se a cobrança ocorre apenas quando houver resultado útil.
timenumberTempo de execução em segundos.
testbooleanIndica se a chamada foi executada em ambiente de teste.

​
Estrutura de result.items[]

CampoTipoDescrição
taxidstringCPF encontrado.
namestringNome da pessoa.
birthdatestringData de nascimento no formato yyyy-mm-dd, quando disponível.
ageintegerIdade calculada, quando disponível.
mother_namestringNome da mãe, quando disponível.
father_namestringNome do pai, quando disponível.
locationstringLocalização resumida, quando disponível.
citystringCidade, quando disponível.
statestringUF, quando disponível.
syntheticbooleanIndica retorno sintético em chamadas sandbox, quando aplicável.
Campos de items[] podem não ser retornados em todas as consultas. A disponibilidade depende dos filtros enviados, do índice consultado e dos dados existentes para o registro encontrado.

​
Paginação

Quando has_more retornar true, envie a mesma requisição incrementando page. 
{
  "name": "CARLOS SANTOS SILVA",
  "mother_name": "MARIA SANTOS SILVA",
  "zipcode": "01001000",
  "page": 2
}

​
Respostas esperadas

As respostas possíveis estão exemplificadas no painel lateral da página.
StatusQuando ocorre
200Busca executada com sucesso.
400Requisição inválida, filtro ausente ou campo em formato incompatível.
401A chave da API está ausente, inválida ou não pôde ser autenticada.
403A credencial não possui escopo de consulta, o plano não permite acesso ou há bloqueio financeiro.

​
Fluxo recomendado

  1. Envie os filtros mais específicos disponíveis.
  2. Use nomes completos para reduzir ambiguidades.
  3. Leia items e verifique has_more.
  4. Se has_more for true, consulte a próxima página.
  5. Use x-ambient: sandbox para validar integração sem consumir saldo.