Skip to main content
POST
https://localapi.lazydata.com.br
/
v1
/
search
/
process
Busca por CPF/CNPJ
curl --request POST \
  --url https://localapi.lazydata.com.br/v1/search/process \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taxid": "<string>",
  "datasets": [
    "<string>"
  ],
  "additional": {}
}
'
{
  "code": 202,
  "message": "Consulta iniciada com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "queued",
    "status_values": ["queued", "processing", "completed", "failed"],
    "datasets": ["process_cnj_pje"]
  }
}
Inicia uma consulta processual usando um CPF ou CNPJ e os datasets processuais informados no corpo da requisição. Consultas processuais são sempre assíncronas. A resposta inicial retorna um id, e o resultado deve ser consultado posteriormente no endpoint de resultado assíncrono. 
{
  "code": 202,
  "message": "Consulta iniciada com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "queued",
    "status_values": ["queued", "processing", "completed", "failed"],
    "datasets": ["process_cnj_pje"]
  }
}

​
Corpo da requisição

​
taxid
string
required
CPF ou CNPJ que será pesquisado nos módulos processuais selecionados. Pontuação é aceita e removida automaticamente.
​
datasets
string[]
required
Lista de IDs dos datasets processuais que serão consultados.
​
additional
object
Dados adicionais por dataset, quando algum dataset exigir parâmetros extras.
​
x-ambient
string
Use sandbox para executar uma chamada de teste sem consumo de saldo.
Para detalhes sobre chamadas de teste, consulte Ambiente de teste.

​
Exemplo de corpo

{
  "taxid": "00000000000",
  "datasets": ["process_cnj_pje"],
  "additional": {}
}
O documento acima é fictício e serve apenas para demonstrar a estrutura da requisição. Em chamadas reais ou sandbox, informe um CPF ou CNPJ válido para o ambiente utilizado.

​
Datasets processuais

Antes de iniciar a consulta, liste os datasets disponíveis em Datasets e preços usando o tipo process. Use apenas datasets com active: true.

​
Parâmetros adicionais por dataset

Alguns datasets podem exigir campos adicionais. Consulte additional_fields no endpoint de datasets e preços para saber quais campos devem ser enviados. Exemplo de envio de dados adicionais: 
{
  "taxid": "00000000000000",
  "datasets": ["process_example_dataset"],
  "additional": {
    "process_example_dataset": {
      "state": "SP"
    }
  }
}

​
Resposta

​
code
integer
required
Código da resposta da API.
​
message
string
required
Mensagem descritiva da resposta.
​
result
object
required
Objeto principal com os dados de acompanhamento da consulta assíncrona.

​
Estrutura de result

CampoTipoDescrição
idstringIdentificador da consulta assíncrona. Use este valor para consultar o resultado depois.
statusstringStatus atual da consulta. Na resposta inicial, normalmente retorna queued.
status_valuesarray<string>Lista de status possíveis da consulta assíncrona.
datasetsarray<string>Datasets processuais solicitados na consulta.

​
Status possíveis

StatusDescrição
queuedConsulta criada e aguardando processamento.
processingConsulta em processamento.
completedConsulta finalizada. Verifique o resultado, erros e status por dataset no endpoint de resultado.
failedConsulta finalizada com falha geral.

​
Consulta do resultado

Após receber o id, consulte o andamento e o resultado final em: 
GET /v1/search/process/{history_id}
Onde history_id é o id retornado na criação da consulta. Consulte a página de resultado assíncrono para ver a estrutura completa do retorno final.

​
Retorno final

Quando a consulta for finalizada, o resultado assíncrono retorna a estrutura completa da busca, incluindo:
CampoDescrição
queryDocumento, datasets e campos adicionais usados na consulta.
costValores debitados e estornados por dataset.
timingTempo total e tempo individual por dataset, quando disponível.
errorsErros por dataset, quando ocorrerem.
datasets_statusStatus individual de cada dataset consultado.
resultDados retornados por cada dataset processual.
Campos descritos na estrutura dos datasets podem não aparecer em todas as consultas. A disponibilidade depende da fonte, do documento consultado e do dataset selecionado.

​
Respostas esperadas

As respostas possíveis estão exemplificadas no painel lateral da página.
StatusQuando ocorre
202Consulta processual iniciada com sucesso.
400Requisição inválida, documento inválido, dataset ausente ou parâmetro 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. Liste os datasets disponíveis em Datasets e preços usando target: process.
  2. Selecione apenas datasets processuais ativos.
  3. Envie o CPF ou CNPJ, os datasets e os campos adicionais necessários.
  4. Guarde o id retornado.
  5. Consulte o resultado em Resultado assíncrono usando target: process.
Evite polling agressivo. Consultas processuais podem levar mais tempo por dependerem de múltiplas fontes e tribunais.