Pagination

Opkit supports the ability to bulk fetch resources using via “list” API methods. For instance, you can list tasks, list calls, and list targets. These list API methods share a common feature: the after query parameter.

The response of a list API method represents a single page in a chronological stream of resources. If you do not specify after, you will receive the first page of this stream, containing the oldest resources. To fetch the next page in the stream, you must send another request with the after parameter set to the ID of the last resource in the previous page. To fetch all resources in the stream, you must repeatedly call the list endpoint, updating after each time, until the response does not include any resources. (This indicates you have reached the end of the stream.)

In the future, we plan to introduce SDKs that support auto-pagination, making it easier to traverse all pages in a list.