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

# Pagination

> How paginated responses work in the SureFeedback API.

Endpoints that return lists support cursor-based or offset-based pagination. The pattern differs slightly by resource, but the parameters are consistent.

## Query parameters

| Parameter  | Type    | Default | Description                                 |
| ---------- | ------- | ------- | ------------------------------------------- |
| `page`     | integer | `1`     | Page number                                 |
| `per_page` | integer | `25`    | Results per page (max `100`)                |
| `limit`    | integer | `10`    | Alternative to `per_page` on some endpoints |

## Paginated response

```json theme={null}
{
  "success": true,
  "data": {
    "data": ["...items..."],
    "current_page": 1,
    "per_page": 25,
    "total": 142,
    "last_page": 6
  }
}
```

## Example

```bash theme={null}
curl "https://api.surefeedback.com/v1/comments?site_id=SITE_ID&page=2&per_page=50" \
  -H "X-API-Key: sf_your_api_key_here"
```

## Filtering

Many list endpoints accept filter parameters as query strings:

```bash theme={null}
GET /api/v1/comments?site_id=SITE_ID&status=open&assigned_to=USER_ID
```

Refer to individual endpoint pages for the full list of supported filters.