Skip to content
TapLogic API
Italiano

Pagination

Lists use cursor pagination: it stays stable even when new scans arrive while you read.

Parameters

  • limit: items per page, 1 to 100 (default 20).
  • cursor: the next_cursor value from the previous page. Treat it as an opaque string.
curl "https://api.taplogic.it/v1/scans?limit=100" \
  -H "Authorization: Bearer $TAPLOGIC_API_KEY"

Response

has_more tells if more pages exist. next_cursor is null on the last page. Items are newest first.

{
  "object": "list",
  "data": [ { "id": "cm3scn0042", "object": "scan" } ],
  "has_more": true,
  "next_cursor": "WyIyMDI2LTExLTE4VDA5OjIwOjAwLjAwMFoiLCJjbTNzY24wMDQyIl0"
}

Reading everything

async function* tuttiITocchi(filtri = {}) {
  let cursore;
  do {
    const query = new URLSearchParams({ ...filtri, limit: "100", ...(cursore ? { cursor: cursore } : {}) });
    const risposta = await fetch(`https://api.taplogic.it/v1/scans?${query}`, {
      headers: { Authorization: `Bearer ${process.env.TAPLOGIC_API_KEY}` },
    });
    const pagina = await risposta.json();
    if (!risposta.ok) throw new Error(pagina.error.code);
    yield* pagina.data;
    cursore = pagina.next_cursor;
  } while (cursore);
}

for await (const tocco of tuttiITocchi({ from: "2026-11-01T00:00:00Z" })) {
  console.log(tocco.id);
}

A cursor stays valid while the filters stay the same. With different filters, start again without a cursor.