List customers
Lists customers. Filter by program, partner, link, click, status or your own customer_id, 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.
Exact match on the customer's customer_id field, the id the customer has in your own system or billing provider; not the Tolt customer id.
Keep only customers at this lifecycle stage, from signed-up leads through trials to paying, canceled or suspended customers. Leave it out to include every stage.
lead, active, canceled, suspended, trialing Text matched anywhere in the customer's email, name, identifier or customer_id, ignoring case.
255Only the customers attributed to this click, by its id (clk_...).
Only customers attributed to this referral link (lnk_...), directly or through one of its clicks.
Response
A page of customers
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.

