Pagination - ChatBridge

List endpoints return at most 10 items per page by default and wrap results in a pagination envelope. There are two envelope styles depending on the endpoint.

Offset pagination

Used by high-volume list endpoints — Contacts, Conversations, and a conversation’s Messages. The response includes a total count and absolute next / previous URLs:

{
  "count": 342,
  "next": "https://api.algosmiths.com/api/v1/contacts/?limit=10&offset=10",
  "previous": null,
  "results": [ /* ... up to `limit` items ... */ ]
}

Control the window with two query parameters:

Parameter	Default	Notes
`limit`	`10`	Items per page. Capped at 200 — larger values are clamped.
`offset`	`0`	Index of the first item to return.

The simplest way to page is to follow the next URL until it’s null.

Cursor pagination

Used by Templates and other list endpoints. Cursor pagination is more stable when the underlying data changes between requests, so it does not include a count:

{
  "next": "https://api.algosmiths.com/api/v1/templates/?cursor=cD0yMDI2LTA3LTEy",
  "previous": null,
  "results": [ /* ... up to 10 items ... */ ]
}

Don’t construct the cursor value yourself — treat it as opaque and follow the next URL. When next is null, you’ve reached the end.

Because cursor responses omit count, you can’t know the total number of results up front — page until next is null. Ordering is newest-first (by creation time).

​Offset pagination

​Cursor pagination

Offset pagination

Cursor pagination