Skip to content

Paging

Some API List methods support paging in order to support larger data sets. Those API collections which do support paging are documented below in each collection under the List method documentation.

There are three optional query string parameters which are used to control paging:

  • cursor: Inclusive value where to begin paged results, i.e., after where last page left off. Defaults to beginning or end of list, depending on direction.
  • direction: 1 to list values after cursor, 0 to list values before cursor, depending on sort algorithm. Defaults to 1.
  • limit: Number of results in page. Usually defaults to 25, and maximum 200.

If the result set was paged due to there being more items, the result set will contain a cursor value indicating where to begin the next page. The next page should be queried using this cursor value in query string. This cursor value should be treated as an opaque string, and not modified in any way. Also, each subsequent page request should contain the exact identical filter query parameters as the first page; otherwise, the paged data integrity cannot be guaranteed.

Fareclock API Documentation