List clicks
Lists recorded clicks. Filter by program, partner, link, country, or device, and page with cursors.
Authorizations
Tolt API key sent as a bearer token.
Query Parameters
How many rows to return in one page.
1 <= x <= 100Ranking direction: desc puts the most recently created or updated rows first.
asc, desc Timestamp to order and page by: created_at follows creation order, updated_at follows each item's most recent change.
created_at, updated_at Continue after a position: the next_cursor of a previous page, or an item id when sorting by created_at. Cannot be combined with ending_before.
Page backward from a position: the prev_cursor of a previous page, or an item id when sorting by created_at. Cannot be combined with starting_after.
Start of a window on when items were created: items created at this time or later are included, for example 2026-01-01T00:00:00Z. Leave it out for no lower bound.
End of a window on when items were created: only items created before this time are included. Leave it out for no upper bound.
Only items last changed at or after this moment; with sort=updated_at, use it to fetch what changed since a previous sync.
Only items last changed before this moment; pair it with updated_after to fetch what changed in a period.
Limit to one program, by its id (prg_...) as returned when listing programs.
Limit to one partner, by its id (part_...) as returned when listing partners.
Limit to one referral link, by its id (lnk_...) as returned when listing links.
Filter by the click's stored country, matched exactly (values are not normalized). Clicks recorded by the tracking script store a country name (e.g. Canada); clicks created through the API store a 2-letter ISO code (e.g. CA). Filter by the exact form you expect.
1"Canada"
Device type, e.g. desktop, mobile or tablet.
1"desktop"
Response
A page of clicks
true
"Request successful"
false
Opaque cursor marking the last item on this page. Pass it as starting_after to continue. Null when the page is empty.
Opaque cursor marking the first item on this page. Pass it as ending_before to page backward. Null when the page is empty.

