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

# Pagination

> How list endpoints return their results page by page.

All endpoints that list resources, for example [List authors](/api-reference/author/list-authors) and [List webhooks](/api-reference/webhooks/list-webhooks), return their results in pages.

## Request

Send these query parameters to choose a page:

**page** `integer` (default: 1)

The page to return, starting at 1.

**pageSize** `integer` (default: 20)

The number of items per page. Maximum 100.

```bash theme={"theme":"nord"}
curl "https://api.moderationapi.com/v1/actions?page=2&pageSize=50" \
  -H "Authorization: Bearer $MODERATION_API_KEY"
```

## Response

A list response has the items in `data` and the position in the full list in `pagination`:

```json theme={"theme":"nord"}
{
  "data": [
    { "id": "act_1", "name": "Suspend for 24 hours" }
  ],
  "pagination": {
    "page": 2,
    "pageSize": 50,
    "total": 51,
    "totalPages": 2,
    "hasMore": false
  }
}
```

**data** `array`

The items on this page.

**pagination** `object`

**properties**

**page** `integer`

The current page, starting at 1.

**pageSize** `integer`

The number of items per page.

**total** `integer`

The total number of items in the list.

**totalPages** `integer`

The total number of pages.

**hasMore** `boolean`

Whether there is a next page.

## Get all items

To get the full list, request the next page while `hasMore` is `true`.

## List filters

Some list endpoints take filters as query parameters. Send a list filter as repeated keys, for example `?labels=spam&labels=toxicity`, or as one comma-separated value, for example `?labels=spam,toxicity`. Send boolean filters as `true` or `false`.