Skip to main content

Cursor-Based Pagination

List endpoints use cursor-based pagination for consistent results:
# First request
response = client.datasets.list(limit=20)

# Get next page
if response.has_more:
    next_response = client.datasets.list(
        limit=20,
        after=response.data[-1].id
    )

Parameters

ParameterTypeDescription
limitintegerResults per page (1-100, default 20)
afterstringReturn results after this ID
beforestringReturn results before this ID

Response Format

{
  "object": "list",
  "data": [...],
  "has_more": true,
  "total_count": 150
}

Filtering

Most list endpoints support filtering:
GET /v1/calls?project=proj_abc&status=pending&created_after=2024-01-01

Common Filters

FilterDescription
projectFilter by project ID
statusFilter by status
created_afterResults after date
created_beforeResults before date

Sorting

GET /v1/evaluations?sort=created_at&order=desc
Default sort is by created_at descending (newest first).