Skip to main content
Most list endpoints in the Poelis Public API support pagination to help you efficiently retrieve large datasets.

Pagination Parameters

All paginated endpoints accept these query parameters:
  • limit: Number of items to return per page (1-200, default: 50)
  • offset: Number of items to skip from the beginning (default: 0)

Basic Usage

Response Format

Paginated responses include:
  • items: Array of resources
  • count: Number of items in the current response (not total count)

Pagination Strategies

Offset-Based Pagination

Use offset and limit to page through results:

Best Practices

Choose Appropriate Limits

Use limit=50 for most cases. Increase only if needed, up to 200

Handle Empty Results

Check if count === 0 to detect end of results