Skip to main content

Pagination

All resources that have support for bulk fetches (i.e. GETting a list of resources) have a common structure: they return a paginated result, and they take at least two query parameters: start_after_id and limit.

Seats.io uses cursor-based pagination: the start_after_id takes an existing object ID value.

Arguments

  • limit: *(optional)* A limit on the number of objects to be returned. The limit` query param should only be passed in once, and must be a number. Its default and max values are 1000, unless specified otherwise, and the minimum is 1.

  • start_after_id: *(optional)* A cursor for use in pagination, which allows you to fetch the next page if it exists. If you make a list request and receive a paginated response that contains a next_page_starts_aftervalue of 123, you can usestart_after_id=123on your next call to fetch the next page of the list.start_after_idcannot be used together withend_before_id`.

  • end_before_id: *(optional)* A cursor for use in pagination, which allows you to fetch the previous page if it exists. If you make a list request and receive a paginated response that contains a previous_page_ends_beforevalue of 987, you can useend_before_id=987on your next call to fetch the previous page of the list.end_before_idcannot be used together withstart_after_id`.

Response format

  • items: (array) An array containing the actual response items. Each item is identified by an id property of type string.
  • next_page_starts_after: (string) Contains the id of the last element in the current list page. Not present if there is no next page (i.e. the items array contains the end of the full list).
  • previous_page_ends_before: (string) Contains the id of the first element in the current list page. Not present if there exists no previous page (i.e. the items array contains the beginning of the full list).