Pagination

Many API endpoints that return lists of items use cursor-based pagination.

How It Works

Paginated responses include:

data - Array of items for the current page
next_cursor - Cursor for the next page (null if no more pages)

Manual Pagination

# First request
curl -X GET "https://api.example.com/items?limit=20"

# Response includes next_cursor
# Use it for the next request
curl -X GET "https://api.example.com/items?limit=20&cursor=abc123"

SDK Examples

The SDKs handle pagination automatically using iterators:

from meibel import MeibelClient

client = MeibelClient(api_key="your-api-key")

# Pagination - iterate over all items
for item in client.agents.list():
    print(item)

⌘I