Skip to main content

Cursor pagination

All list endpoints that return potentially large result sets use cursor-based pagination (before + limit), not page numbers.

Query parameters

ParameterTypeDefaultDescription
limitinteger20Max records to return per page
beforeISO 8601 timestampReturn records created before this timestamp (exclusive)

How to paginate

GET /message-feed?conversation_id=<id>&limit=20
→ Returns 20 items sorted newest-first

// Take the created_at of the last item in the response, pass it as `before`
GET /message-feed?conversation_id=<id>&limit=20&before=2026-04-18T10:00:00Z
→ Returns the next 20 items

Response shape

Paginated endpoints return a data array directly. When the array length is less than limit, you’ve reached the end.
{
  "success": true,
  "status": 200,
  "data": [ ...items ]
}

Endpoints that support pagination

EndpointPagination params
GET /message-feedlimit, before
GET /notification-listlimit, before
GET /transaction-listlimit, before
GET /escrow-listlimit, before
GET /review-listlimit, before