Skip to main content

Pagination

List endpoints support pagination via query parameters:

ParameterDefaultDescription
start0Offset to start from
limit30Number of records to return (max varies by entity)
orderByvariesField to sort by
orderByDirASCSort direction (ASC or DESC)

Responses include a total field with the full count of matching records:

{
"total": 150,
"segments": [ ... ]
}

total is an integer on most endpoints. On the endpoints below it is returned as a numeric string (e.g. "150") for backward compatibility — cast it on the client side:

  • GET /contacts
  • GET /companies
  • GET /campaigns/{id}/contacts
  • GET /forms/{formId}/submissions and GET /forms/{formId}/submissions/contact/{contactId}
  • GET /stats/{table}