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

# Pagination

> How collections are paginated in the API.

Endpoints which return collections (e.g. `/projects`, `/orders`) will return paginated results.

The following parameters can be passed for paginated objects:

| Parameter  | Meaning                |
| ---------- | ---------------------- |
| page       | Page to return         |
| page\_size | Size of page to return |

```
{
	page: 1,
	page_size: 10
}
```

Here's an example query string `/api/v0.1/projects?page=1&page_size=10`.

If an object is paginated, the results will be returned in the `data` object and pagination information will be returned in the `info` object:

<CodeGroup>
  ```json json theme={null}
  {
    "data": [...],
    "info": {
      "items": 10,
      "page_size": 10,
      "total_items": 15,
      "current_page": 1,
      "next_page": 2,
      "previous_page": null,
      "total_pages": 1
    }
  }
  ```
</CodeGroup>

| Field          | Meaning                                 |
| -------------- | --------------------------------------- |
| items          | Number of items returned in the results |
| total\_items   | Total number of items across all pages  |
| current\_page  | Current page of the request             |
| next\_page     | Page number of next page of results     |
| previous\_page | Page number of previous page of results |
| total\_pages   | The total number of pages of results    |