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

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

Example response

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