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

# Query Contexts

> List all voucher contexts for the authenticated user.

`GET /api/v1/vouchers/contexts`

Returns a paginated list of contexts ordered by creation time (newest first).

## Parameters

### Query

| Name     | Type      | Required | Description                                                 |
| -------- | --------- | -------- | ----------------------------------------------------------- |
| `limit`  | `integer` | No       | Number of items to return (default 100)                     |
| `offset` | `integer` | No       | Number of items to skip for pagination                      |
| `since`  | `integer` | No       | Unix timestamp (ms) — return items created after this time  |
| `until`  | `integer` | No       | Unix timestamp (ms) — return items created before this time |

## Request example

```shell theme={null}
curl --request GET 'https://payments.bleepay.com/api/v1/vouchers/contexts?limit=20' \
  --header 'Authorization: Bearer <payer_token>'
```

## Response

Returns an array of context objects. See [Get Context](/api-reference/vouchers/contexts/get-context) for the object schema.

### Example response

```json theme={null}
[
  {
    "id": "ctx_a1b2c3d4e5f6",
    "code": "A1B2C3",
    "status": "OPEN",
    "format": "numeric",
    "payers": [
      { "address": "0x1234567890abcdef1234567890abcdef12345678" }
    ],
    "createdAt": "2026-06-09T12:00:00.000Z",
    "updatedAt": "2026-06-09T12:00:00.000Z"
  }
]
```