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

# Pagination

> How pagination works across list endpoints.

## Pattern

All list endpoints that support pagination use a consistent pattern.

**Query parameters:**

| Parameter | Default | Description                   |
| --------- | ------- | ----------------------------- |
| `limit`   | `100`   | Max results per page (1–1000) |
| `offset`  | `0`     | Number of results to skip     |

**Response envelope:**

Every paginated response includes a `pagination` object:

```json theme={null}
{
  "pagination": {
    "limit": 100,
    "offset": 0,
    "returned": 42
  }
}
```

When `returned < limit`, you've reached the end of the results.

## Paginated Endpoints

| Endpoint           | Description              |
| ------------------ | ------------------------ |
| `GET /devices`     | List devices             |
| `GET /lock-events` | Query lock/unlock events |