Skip to main content
GET
https://api.lazydata.com.br/
/
v1
/
search
/
history
/
{history_id}
Detalhar histórico
curl --request GET \
  --url https://api.lazydata.com.br/v1/search/history/{history_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "message": "Histórico da consulta retornado com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "completed",
    "status_values": ["queued", "processing", "completed", "completed_with_errors", "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": "completed"
    },
    "datasets_meta": {
      "person_basic_data": {
        "id": "person_basic_data",
        "name": "Dados básicos",
        "target": "pf"
      }
    },
    "result": {
      "person_basic_data": {
        "tax_id": "00000000000",
        "name": "PESSOA EXEMPLO"
      }
    },
    "created_at": "2026-06-22T12:00:00Z",
    "last_updated_at": "2026-06-22T12:00:01Z"
  }
}
Retorna o detalhe de uma consulta armazenada no histórico da conta autenticada. Use este endpoint para recuperar resultado, custos, estornos, tempos, erros, status por dataset e metadados de datasets depois da janela curta de polling assíncrono.
Este endpoint exige credencial com escopo history. Ele não executa novamente os datasets e não atualiza os dados da consulta.
{
  "code": 200,
  "message": "Histórico da consulta retornado com sucesso.",
  "result": {
    "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
    "status": "completed",
    "status_values": ["queued", "processing", "completed", "completed_with_errors", "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": "completed"
    },
    "datasets_meta": {
      "person_basic_data": {
        "id": "person_basic_data",
        "name": "Dados básicos",
        "target": "pf"
      }
    },
    "result": {
      "person_basic_data": {
        "tax_id": "00000000000",
        "name": "PESSOA EXEMPLO"
      }
    },
    "created_at": "2026-06-22T12:00:00Z",
    "last_updated_at": "2026-06-22T12:00:01Z"
  }
}

​
Parâmetros

​
history_id
string
required
ID do histórico da consulta.

​
Estrutura de result

CampoDescrição
idIdentificador do histórico.
statusStatus geral da consulta.
status_valuesStatus possíveis para acompanhamento.
targetTipo público da consulta: person, company, process ou vehicle.
queryDocumento, datasets e campos adicionais usados na consulta.
costValores cobrados e estornados.
timingTempo total e tempo individual por dataset.
errorsErros por dataset ou falhas globais.
cacheInformações de cache, quando aplicável.
datasets_statusStatus individual de cada dataset solicitado.
datasets_metaNome, descrição e estrutura dos datasets usados.
resultResultado agrupado por dataset.
created_atData de criação do histórico.
last_updated_atÚltima atualização do histórico.

​
Diferença para resultado assíncrono

GET /v1/search/{target}/{history_id} é indicado para polling logo após iniciar uma consulta assíncrona e pode respeitar janela curta de leitura. GET /v1/search/history/{history_id} consulta o histórico armazenado da conta, conforme plano, permissão e política de retenção.

​
Próximos passos

Listar histórico

Liste consultas anteriores com filtros e paginação.

Resultado assíncrono

Faça polling de uma consulta recém-iniciada.