> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poelis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> How list endpoints are paginated in the Poelis API

List endpoints (workspaces, products, items, etc.) are paginated. This page covers the API contract; for strategies and code examples, see [Pagination](/guides/pagination).

## Query Parameters

| Parameter | Type    | Default | Description                            |
| --------- | ------- | ------- | -------------------------------------- |
| `limit`   | integer | 50      | Number of items per page (1–200)       |
| `offset`  | integer | 0       | Number of items to skip from the start |

* **`limit`**: Min 1, max 200. Values outside this range are invalid (typically 422).
* **`offset`**: Min 0. Use `offset = 0` for the first page, then `offset = limit` for the next, and so on.

## Request Examples

```bash theme={null}
# First page (default: 50 items)
GET /v1/public/workspaces

# First page, 20 items
GET /v1/public/workspaces?limit=20&offset=0

# Second page (items 21–40)
GET /v1/public/workspaces?limit=20&offset=20
```

## Response Shape

Paginated list responses always use this structure:

```json theme={null}
{
  "items": [
    { "id": "...", "name": "...", ... },
    { "id": "...", "name": "...", ... }
  ],
  "count": 2
}
```

* **`items`**: Array of resources for the current page.
* **`count`**: Number of items in **this** response (i.e. `items.length`), not the total number of resources across all pages.

There is no `total` field. To fetch all pages, keep requesting with increasing `offset` until you receive fewer items than `limit` (or zero). See [Pagination](/guides/pagination) for full examples in Python and JavaScript.

## Which Endpoints Are Paginated?

Any list endpoint that returns a collection ([List workspaces](/api-reference/workspaces/list-workspaces), [List products](/api-reference/products/list-products-in-a-workspace), [List items](/api-reference/items/list-items-in-a-product), [List properties](/api-reference/properties/list-properties-for-an-item)) supports `limit` and `offset`. Single-resource endpoints (e.g. get workspace by ID) do not use pagination.