Convoy’s API uses cursor-based pagination through the next_page_cursor and prev_page_cursor parameters. Both parameters accept an existing object ID value and return objects in reverse chronological order. The prev_page_cursor parameter returns objects listed before the named object. The next_page_cursor parameter returns objects listed after the named object. These parameters are mutually exclusive. You can use either the next_page_cursor or prev_page_cursor parameter, but not both simultaneously. Full description of each parameter is described below.

​
Parameters

​
perPage
integer
default:"50"
Number of objects per response.
​
direction
string
default:"next"
This parameter is used to decide if the pagination is forward or backward. It can either be next or prev.
​
next_page_cursor
string
A cursor to use in pagination. It specifies your current place in the list and is used to query the next page.
​
prev_page_cursor
string
A cursor to use in pagination. It specifies your current place in the list and is used to query the previous page.