Pagination

Use the page parameter to determine which page of results to return, relative to the default or specified limit. Defaults to 1.

Use skip to offset results directly—when set, it overrides the offset normally computed as (page - 1) × limit.

Two special values are supported: page=all removes the limit and returns all matching records in one response, and page=false disables pagination entirely, returning a plain array of records without the usual response envelope.

Paginated responses include count (total matching records), results, page, limit, page_count, and a pages map with the start and end record numbers of each page. The pages map is left out when the results fit on one page. It covers a window of pages around the current page, 10 by default; use window to change it. With page=all, every matching record is returned, and limit and page_count still reflect the default page size.

{
  "count": 42,
  "results": [
    { "...": "..." }
  ],
  "page": 2,
  "limit": 15,
  "page_count": 3,
  "pages": {
    "1": { "start": 1, "end": 15 },
    "2": { "start": 16, "end": 30 },
    "3": { "start": 31, "end": 42 }
  }
}