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

# Pagination

> How list endpoints paginate results.

List endpoints accept `page` and `limit` query parameters and return a
`pagination` object alongside the `data` array.

## Request

```bash theme={null}
GET /v1/escrow/transactions?type=sales&page=1&limit=10
```

| Parameter | Default | Description            |
| --------- | ------- | ---------------------- |
| `page`    | `1`     | Page number (1-based). |
| `limit`   | `10`    | Items per page.        |

## Response

Paginated payloads nest the records under `data.data`, with a sibling
`pagination` object:

```json theme={null}
{
  "status": 200,
  "message": "Transaction fetched successfully",
  "data": {
    "data": [
      { "id": "665f1b2c9a1e4d0012ab3c10", "amount": 150000, "status": "ONGOING" }
    ],
    "pagination": {
      "count": 1,
      "pages": 1,
      "isLastPage": true,
      "nextPage": null,
      "previousPage": null
    }
  }
}
```

| Field          | Description                                            |
| -------------- | ------------------------------------------------------ |
| `count`        | Total number of matching records.                      |
| `pages`        | Total number of pages.                                 |
| `isLastPage`   | `true` when there are no further pages.                |
| `nextPage`     | The next page number, or `null` on the last page.      |
| `previousPage` | The previous page number, or `null` on the first page. |

<Tip>
  To iterate the full set, keep requesting `nextPage` until `isLastPage` is
  `true`.
</Tip>