Skip to main content
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

{
  "total": 38,
  "page": 2,
  "page_size": 5,
  "has_more": true,
  "data": [
    { "id": "ex_101", "status": "success", "created_at": "..." },
    { "id": "ex_102", "status": "failed", "created_at": "..." },
    ...
  ]
}

​
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.