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

# GET /v1/subscriptions/:id/filters/addresses

> List all address filters for a subscription with cursor-based pagination. Use this when a subscription has more than 200 addresses.

The subscription resource embeds up to 200 addresses inline in its `filters.addresses` array. When a subscription exceeds that limit, `filters.hasMore` is `true` and you use this endpoint to page through the full list using an opaque cursor token.

## Request

```
GET /v1/subscriptions/:id/filters/addresses
```

### Path parameters

<ParamField path="id" type="string" required>
  The subscription ID (e.g. `sub_2QkP9aB7xN...`).
</ParamField>

### Query parameters

<ParamField query="limit" type="integer">
  Number of addresses to return per page. Must be between 1 and 200. Defaults to `50`.
</ParamField>

<ParamField query="nextPageToken" type="string">
  Opaque cursor returned by the previous response. Pass this value verbatim to fetch the next page. Omit or leave empty to start from the beginning.
</ParamField>

```bash theme={null}
curl "https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN.../filters/addresses?limit=50" \
  -H "Authorization: Bearer oth_YOUR_API_KEY"
```

## Response

**200 OK** — a paginated list of address objects.

```json theme={null}
{
  "items": [
    { "chainId": "tron:mainnet", "address": "TLsV52sRDL79HXGGm9yzwKibb6BeruhUzy" },
    { "chainId": "tron:nile", "address": "TLsV52sRDL79HXGGm9yzwKibb6BeruhUzy" }
  ],
  "nextPageToken": "v1:..."
}
```

<ResponseField name="items" type="array">
  The address objects on this page. Each item has a `chainId` (CAIP-2 identifier, e.g. `tron:mainnet`) and an `address` (base58check-encoded TRON address).
</ResponseField>

<ResponseField name="nextPageToken" type="string | null">
  Cursor for the next page. Pass this as the `nextPageToken` query parameter on your next request. `null` when you have reached the last page.
</ResponseField>

## Errors

| Code                       | HTTP | Description                                                                      |
| -------------------------- | ---- | -------------------------------------------------------------------------------- |
| `not_found`                | 404  | The subscription ID does not exist or belongs to a different API key.            |
| `invalid_pagination_token` | 400  | The `nextPageToken` value is malformed or was issued by a different API version. |
| `unauthorized`             | 401  | The `Authorization` header is missing or the key is invalid.                     |