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:
Seats.io uses cursor-based pagination: the
start_after_id takes an existing object ID value.
A limit on the number of objects to be returned. The
limitquery 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 use
start_after_id=123on your next call to fetch the next page of the list.
start_after_idcannot be used together with
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 use
end_before_id=987on your next call to fetch the previous page of the list.
end_before_idcannot be used together with
- items (array)
An array containing the actual response items. Each item is identified by an
idproperty 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
itemsarray 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
itemsarray contains the beginning of the full list).