Resultado assíncrono

curl --request GET \
  --url https://localapi.lazydata.com.br/v1/search/{target}/{history_id} \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "message": "Histórico da consulta retornado com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "processing",
    "status_values": ["queued", "processing", "completed", "failed"],
    "target": "person",
    "query": {
      "taxid": "00000000000",
      "datasets": ["person_basic_data"],
      "additional": {}
    },
    "cost": {
      "total": 0.05,
      "refunded": 0,
      "datasets": {
        "person_basic_data": {
          "charged": 0.05,
          "refunded": 0
        }
      }
    },
    "timing": {
      "total": 0.42,
      "datasets": {
        "person_basic_data": 0.42
      }
    },
    "errors": {},
    "cache": {},
    "datasets_status": {
      "person_basic_data": "processing"
    },
    "result": {},
    "created_at": "2026-06-22T12:00:00Z",
    "last_updated_at": "2026-06-22T12:00:01Z"
  }
}

GET

https://localapi.lazydata.com.br

{target}

{history_id}

Resultado assíncrono

curl --request GET \
  --url https://localapi.lazydata.com.br/v1/search/{target}/{history_id} \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "message": "Histórico da consulta retornado com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "processing",
    "status_values": ["queued", "processing", "completed", "failed"],
    "target": "person",
    "query": {
      "taxid": "00000000000",
      "datasets": ["person_basic_data"],
      "additional": {}
    },
    "cost": {
      "total": 0.05,
      "refunded": 0,
      "datasets": {
        "person_basic_data": {
          "charged": 0.05,
          "refunded": 0
        }
      }
    },
    "timing": {
      "total": 0.42,
      "datasets": {
        "person_basic_data": 0.42
      }
    },
    "errors": {},
    "cache": {},
    "datasets_status": {
      "person_basic_data": "processing"
    },
    "result": {},
    "created_at": "2026-06-22T12:00:00Z",
    "last_updated_at": "2026-06-22T12:00:01Z"
  }
}

Retorna o status atual e os dados disponíveis de uma consulta iniciada anteriormente em modo assíncrono. Use este endpoint para implementar polling após receber o id de uma consulta com status queued ou processing.

{
  "code": 200,
  "message": "Histórico da consulta retornado com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "processing",
    "status_values": ["queued", "processing", "completed", "failed"],
    "target": "person",
    "query": {
      "taxid": "00000000000",
      "datasets": ["person_basic_data"],
      "additional": {}
    },
    "cost": {
      "total": 0.05,
      "refunded": 0,
      "datasets": {
        "person_basic_data": {
          "charged": 0.05,
          "refunded": 0
        }
      }
    },
    "timing": {
      "total": 0.42,
      "datasets": {
        "person_basic_data": 0.42
      }
    },
    "errors": {},
    "cache": {},
    "datasets_status": {
      "person_basic_data": "processing"
    },
    "result": {},
    "created_at": "2026-06-22T12:00:00Z",
    "last_updated_at": "2026-06-22T12:00:01Z"
  }
}

Parâmetros

target

string

required

Tipo da consulta assíncrona que será detalhada.

Valores aceitos para target:

Valor	Descrição
`person`	Consulta de pessoa física.
`company`	Consulta de pessoa jurídica.
`process`	Consulta processual.
`vehicle`	Consulta veicular.

history_id

string

required

ID retornado ao iniciar a consulta assíncrona.

Resposta

code

integer

required

Código da resposta da API.

message

string

required

Mensagem descritiva da resposta.

result

object

Objeto principal com o status, dados da consulta, custos, tempos, erros e retorno dos datasets.

Estrutura de `result`

Campo	Tipo	Descrição
`id`	`string`	Identificador único da consulta.
`status`	`string`	Status atual da consulta.
`status_values`	`array<string>`	Lista de status possíveis para consultas assíncronas.
`target`	`string`	Tipo público da consulta: `person`, `company`, `process` ou `vehicle`.
`query`	`object`	Dados usados para iniciar a consulta.
`cost`	`object`	Valores cobrados e estornados.
`timing`	`object`	Tempo total e tempo individual por dataset, quando disponível.
`errors`	`object`	Erros por dataset, quando ocorrerem.
`cache`	`object`	Informações de cache por dataset, quando aplicável.
`datasets_status`	`object`	Status individual de cada dataset solicitado.
`result`	`object`	Resultado agrupado por dataset. Pode ficar vazio enquanto a consulta estiver em andamento.
`created_at`	`string`	Data de criação da consulta em ISO 8601.
`last_updated_at`	`string`	Data da última atualização da consulta em ISO 8601.

Status da consulta

Status	Descrição
`queued`	Consulta criada e aguardando processamento.
`processing`	Consulta em processamento.
`completed`	Consulta finalizada. Verifique `errors` para identificar falhas parciais por dataset.
`failed`	Consulta finalizada com falha geral.

Estrutura de `query`

Campo	Tipo	Descrição
`taxid`	`string`	CPF ou CNPJ consultado, quando a consulta usa documento.
`plate`	`string`	Placa consultada, quando a consulta é veicular.
`datasets`	`array<string>`	Datasets solicitados na consulta.
`additional`	`object`	Campos adicionais enviados por dataset.

Estrutura de `cost`

Campo	Tipo	Descrição
`total`	`number`	Valor total efetivamente debitado.
`refunded`	`number`	Valor total estornado.
`datasets`	`object`	Detalhamento financeiro por dataset.

Estrutura de `cost.datasets`

Cada chave representa um dataset solicitado.

Campo	Tipo	Descrição
`charged`	`number`	Valor cobrado pelo dataset.
`refunded`	`number`	Valor estornado para o dataset.

Estrutura de `timing`

Campo	Tipo	Descrição
`total`	`number`	Tempo total da consulta em segundos, quando disponível.
`datasets`	`object`	Tempo individual por dataset em segundos.

Estrutura de `errors`

O campo errors retorna um objeto indexado pelo ID do dataset quando alguma base falha.

{
  "errors": {
    "person_example_dataset": {
      "code": 42025,
      "message": "Não foi possível consultar o provedor da consulta."
    }
  }
}

Estrutura de `datasets_status`

Objeto indexado pelo ID do dataset.

{
  "datasets_status": {
    "person_basic_data": "completed",
    "person_example_dataset": "failed"
  }
}

Estrutura de `result.result`

Objeto indexado pelo ID do dataset. Cada chave contém o retorno final do dataset correspondente.

{
  "result": {
    "company_basic_data": {
      "tax_id": "00000000000000",
      "name": "EMPRESA EXEMPLO LTDA",
      "status": "ATIVA"
    }
  }
}

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.

Janela de leitura

O resultado assíncrono fica disponível para leitura por uma janela limitada após a criação da consulta. Atualmente, a janela de leitura é de aproximadamente 30 minutos. Após esse período, a API pode retornar 404.

Polling recomendado

Inicie a consulta em modo assíncrono.
Guarde o id retornado.
Consulte este endpoint usando o target correspondente.
Enquanto status for queued ou processing, repita a consulta com intervalo progressivo.
Ao receber completed ou failed, pare o polling e trate result, errors e datasets_status.

Evite polling agressivo. Para consultas com múltiplos datasets ou processos, use intervalos maiores para reduzir carga desnecessária.

Datasets e preços Busca por CPF

​Parâmetros

​Resposta

​Estrutura de result

​Status da consulta

​Estrutura de query

​Estrutura de cost

​Estrutura de cost.datasets

​Estrutura de timing

​Estrutura de errors

​Estrutura de datasets_status

​Estrutura de result.result

​Janela de leitura

​Polling recomendado

Parâmetros

Resposta

Estrutura de `result`

Status da consulta

Estrutura de `query`

Estrutura de `cost`

Estrutura de `cost.datasets`

Estrutura de `timing`

Estrutura de `errors`

Estrutura de `datasets_status`

Estrutura de `result.result`

Janela de leitura

Polling recomendado