# Pagination and query parameters

Follow cursor-based pages and use list filters without changing resource scope.

Product: Client Trade API
Guides follow API reference 0.3.0 and event reference 0.2.0.
Canonical page: https://docs.axiym.io/trade-api/integration-guide/fundamentals/pagination-and-query-parameters

Paginated list endpoints use cursor-based pagination and can support
resource-specific filters. Not every list endpoint is paginated; use `first`
and `after` only where documented in the API Reference. Keep using the product's
documented resource path while following a page sequence.

## Pagination

| Parameter | Description                                                  |
| --------- | ------------------------------------------------------------ |
| `first`   | Maximum items to return. The maximum is `100`.               |
| `after`   | Cursor returned as the previous page's `pageInfo.endCursor`. |

Omit `after` on the first request. Treat cursors as opaque strings.

```json
{
  "nodes": [],
  "pageInfo": {
    "hasNextPage": true,
    "endCursor": "eyJvZmZzZXQiOjI1fQ=="
  }
}
```

Keep the owner, filters, and sort context unchanged while following pages.

## List filters

Available filters depend on the resource. The API Reference is the source of
truth for the query parameters accepted by an operation.

Query parameters must be URL-encoded and combined with `&`.

```sh
curl \
  "https://partner-api.sandbox.axiym.io/api/v1/webhooks/subscriptions?first=20" \
  --header "Authorization: Bearer $AXIYM_ACCESS_TOKEN"
```