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

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 for the object schema.

Example response

[
  {
    "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"
  }
]