> ## 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 Vouchers

> List all vouchers for the authenticated user.

`GET /api/v1/vouchers/`

Returns a paginated list of vouchers ordered by creation time. Useful for checking the status of multiple vouchers at once.

## 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                |
| `status` | `string`  | No       | Filter by voucher status (`RESERVED`, `REDEEMED`, `RESOLVED`, `DISCARDED`) |

## Request example

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

## Response

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

### Example response

```json theme={null}
[
  {
    "id": "vch_482916",
    "code": "482916",
    "status": "RESOLVED",
    "type": "SIMPLE",
    "expectedPayment": {
      "network": "polygon",
      "currency": "EURC",
      "currencyAddress": "0x73b3db5a96a4b9d9bcfc22b8f1b3d85a5e5b5e5b",
      "amount": "100",
      "wallet": { "address": "0xYourWalletAddress" }
    },
    "createdAt": "2026-06-09T12:00:00.000Z",
    "updatedAt": "2026-06-09T12:01:00.000Z"
  }
]
```