# Pagination

List queries accept pagination:

| Argument | Type | Description |
|  --- | --- | --- |
| `page` | Int | Page number (starts at 1) |
| `perPage` | Int | Items per page |


Example variables:


```json
{ "page": 1, "perPage": 20 }
```

List responses include a `pagination` object with `totalCount`, `currentPage`, `totalPages`, `hasNextPage`, and `hasPreviousPage`.

### Example

Pass `page` and `perPage` on list queries such as `tags`, `customers`, and `conversations`.


```graphql
query {
  customers(page: 2, perPage: 20) {
    data { _id firstName }
    pagination {
      totalCount
      currentPage
      hasNextPage
    }
  }
}
```


```graphql
query {
  customers(page: 2, perPage: 20) {
    data { _id firstName }
    pagination {
      totalCount
      hasNextPage
    }
  }
}
```