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.