GET
/
consultas
/
logs
Listar histórico de execuções
curl --request GET \
  --url https://api.sollosconsultas.com.br/consultas/logs \
  --header 'x-access-token: <api-key>'
{
  "data": [
    {
      "id": 4201,
      "query_name": "kyc_pf",
      "query_display_name": "KYC — Pessoa Física",
      "status": "success",
      "response_time_ms": 843,
      "executed_at": "2026-04-10T14:32:00.000Z"
    },
    {
      "id": 4200,
      "query_name": "scr_pf",
      "query_display_name": "SCR — Pessoa Física",
      "status": "success",
      "response_time_ms": 1204,
      "executed_at": "2026-04-10T13:15:00.000Z"
    },
    {
      "id": 4195,
      "query_name": "kyc_pj",
      "query_display_name": "KYC — Pessoa Jurídica",
      "status": "failed",
      "response_time_ms": 3001,
      "executed_at": "2026-04-09T09:40:00.000Z"
    }
  ],
  "pagination": {
    "hasNextPage": true,
    "nextCursor": "eyJpZCI6NDE5NSwiZXhlY3V0ZWRfYXQiOiIyMDI2LTA0LTA5VDA5OjQwOjAwLjAwMFoifQ=="
  }
}

Paginação por cursor

Este endpoint usa cursor-based pagination — não há conceito de “página 1, página 2”. Em vez disso:
  1. Na primeira requisição, omita o parâmetro cursor
  2. Se pagination.hasNextPage for true, a resposta contém um nextCursor
  3. Passe nextCursor como cursor na próxima requisição para obter os registros seguintes
  4. Repita até hasNextPage ser false
Exemplo de iteração completa
async function buscarTodosOsLogs(token, days = 30) {
  const logs = [];
  let cursor = undefined;

  do {
    const params = new URLSearchParams({ days, page_size: 100 });
    if (cursor) params.set('cursor', cursor);

    const resp = await fetch(
      `https://api.sollosconsultas.com.br/consultas/logs?${params}`,
      { headers: { 'x-access-token': token } }
    );

    const { data, pagination } = await resp.json();
    logs.push(...data);
    cursor = pagination.nextCursor;

  } while (cursor);

  return logs;
}
O cursor é opaco — não tente interpretar ou construir seu valor manualmente. Sempre use exatamente o valor retornado em pagination.nextCursor.

Entendendo o campo id

O id de cada item no array data é o identificador permanente daquela execução. Use-o em GET /consultas/logs/details/{id} para obter a resposta completa do provedor para aquela execução específica.

Authorizations

x-access-token
string
header
required

Token JWT retornado pelo endpoint POST /auth/login. Inclua este header em todas as requisições autenticadas.

Query Parameters

days
integer
default:15

Janela de busca em dias a partir de hoje. Padrão: 15. Máximo: 365.

Required range: 1 <= x <= 365
page_size
integer
default:25

Quantidade de registros por página. Padrão: 25. Máximo: 100.

Required range: 1 <= x <= 100
cursor
string

Cursor da próxima página. Obtido em pagination.nextCursor da resposta anterior. Omita na primeira requisição.

Response

Lista de execuções com metadados de paginação.

data
object[]
pagination
object

Metadados de paginação por cursor. Use nextCursor na próxima requisição para obter a página seguinte.