Some of our API's return multiple pages of data. These API's can be paged through by using the returned continuation token on the next request.

We currently support two methods of token pagination:

1. 'X-Continuation-Token' Header

This method is the recommended approach, but it is currently opt-in. To opt-in, provide an empty string X-Continuation-Token header on the first request. If the response contains an X-Continuation-Token header, it can be used to request the next page by making the identical request again with the new token. If the response does not return an X-Continuation-Token header, then there are no more items.

2. 'after' URL Parameter

This method is still supported and is documented on each API's page, but will be deprecated in the future due to a limitation on large token sizes. If you are experiencing request errors due to the URL being too long, it is advised to switch to using X-Continuation-Token immediately.