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

# Pagination

> Use pagination objects for Finup list endpoints.

List endpoints use a `pagination` object in the request body.

```json theme={null}
{
  "pagination": {
    "page": 1,
    "per_page": 25,
    "sort_by": "created_at",
    "sort_direction": "desc"
  }
}
```

| Field            | Type   | Description                                    |
| ---------------- | ------ | ---------------------------------------------- |
| `page`           | number | Page number, starting at `1`.                  |
| `per_page`       | number | Number of records to return.                   |
| `sort_by`        | string | Optional sort field supported by the endpoint. |
| `sort_direction` | string | `asc` or `desc`.                               |

Paginated responses include page metadata when the endpoint supports total counts.

```json theme={null}
{
  "result": {
    "current_page": 1,
    "total_records": 125,
    "total_pages": 5,
    "data": []
  }
}
```

For transaction tables, use the same filters for `/transactions`, `/transactions/count`, and `/transactions/summary`.