The endpoints also support pagination using the page_number and page_size query parameters. This allows you to fetch large sets of results in smaller, manageable chunks.

Query Parameters

  • page_number (integer, optional): The page of results to retrieve. Defaults to 1. The first page starts at 1.
  • page_size (integer, optional): The number of results per page. Defaults to 20. You can request up to 50 results per page.

How it works

The API uses offset-based pagination under the hood. For example:

page_numberpage_sizeReturned records
110Records 1–10
210Records 11–20
35Records 11–15

Example Request

GET /v2/agent/1234/executions?page_number=2&page_size=5

Tips

  • Use has_more to determine if you should fetch the next page.
  • Combine pagination with filters supported in the API to narrow results efficiently.