> ## Documentation Index > Fetch the complete documentation index at: https://docs.gvb-staging.co.uk/llms.txt > Use this file to discover all available pages before exploring further. # List purchased vouchers > `view_vouchers` and `view_orders` permissions required. All successful responses include `X-Request-Id` and `Cache-Control: private, no-store`. Requests are limited to 120 per minute. ## OpenAPI ````yaml /openapi.json get /tenants/{tenant}/sales/purchased-vouchers openapi: 3.1.0 info: title: Gift Voucher Brilliance External API version: 1.0.0 description: >- Read-only synchronisation and controlled voucher redemption for approved integrations. All operations require a bearer token. The API is limited to 120 requests per minute per token/IP combination. contact: name: Gift Voucher Brilliance Support url: https://docs.giftvoucherbrilliance.co.uk/support servers: - url: https://app.giftvoucherbrilliance.co.uk/api/external/v1 description: Production - url: https://app.gvb-staging.co.uk/api/external/v1 description: Staging - url: https://app.gvb.test/api/external/v1 description: Local security: - bearerAuth: [] tags: - name: Tenants description: Discover tenants available to the token. - name: Catalog description: Synchronise voucher products and categories. - name: Sales description: Synchronise purchased vouchers and balances. - name: Customers description: Export customers who opted in to marketing. - name: Redemptions description: Resolve, validate, and redeem vouchers. paths: /tenants/{tenant}/sales/purchased-vouchers: get: tags: - Sales summary: List purchased vouchers description: >- `view_vouchers` and `view_orders` permissions required. All successful responses include `X-Request-Id` and `Cache-Control: private, no-store`. Requests are limited to 120 per minute. operationId: listPurchasedVouchers parameters: - name: tenant in: path required: true description: Authorised tenant identifier from the tenant directory. schema: type: integer - name: updated_since in: query description: Return records updated at or after this ISO-8601 timestamp. schema: type: - string - 'null' format: date-time - name: cursor in: query description: >- Opaque cursor from `next_cursor`; do not inspect or modify it. Page size is fixed at 50. schema: type: - string - 'null' - name: Accept in: header required: true description: Must be `application/json`. schema: type: string enum: - application/json example: application/json responses: '200': description: Successful response. content: application/json: schema: $ref: '#/components/schemas/PurchasedVoucherCollection' headers: X-Request-Id: description: Request correlation identifier. schema: type: string Cache-Control: description: Sensitive responses are not shared or stored. schema: type: string example: private, no-store '401': description: Unauthenticated or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/MessageError' '403': description: Token lacks the required tenant access or permission. content: application/json: schema: $ref: '#/components/schemas/MessageError' '404': description: Resource or tenant was not found in the authorised scope. content: application/json: schema: $ref: '#/components/schemas/MessageError' '422': description: Request validation failed. content: application/json: schema: $ref: '#/components/schemas/ValidationError' '429': description: Rate limit exceeded. Retry after the window resets. content: application/json: schema: $ref: '#/components/schemas/MessageError' components: schemas: PurchasedVoucherCollection: type: object properties: data: type: array items: $ref: '#/components/schemas/PurchasedVoucher' next_cursor: type: - string - 'null' server_time: type: string format: date-time description: ISO-8601 timestamp. required: - data - next_cursor - server_time title: PurchasedVoucherCollection MessageError: type: object properties: message: type: string required: - message title: MessageError ValidationError: type: object properties: message: type: string errors: type: object additionalProperties: type: array items: type: string required: - message - errors title: ValidationError PurchasedVoucher: type: object properties: id: type: integer reference: type: string order_id: type: - integer - 'null' order_item_id: type: - integer - 'null' product_id: type: - integer - 'null' product_title: type: - string - 'null' product_slug: type: - string - 'null' parent_product_id: type: - integer - 'null' parent_product_title: type: - string - 'null' purchase_timestamp: type: - string - 'null' format: date-time description: ISO-8601 timestamp. date_issued: type: - string - 'null' format: date-time description: ISO-8601 timestamp. date_valid_start: type: - string - 'null' format: date description: ISO-8601 calendar date. date_valid_end: type: - string - 'null' format: date description: ISO-8601 calendar date. date_scheduled: type: - string - 'null' format: date-time description: ISO-8601 timestamp. initial_balance: type: - integer - 'null' description: Amount in minor currency units (for example 2500 means £25.00). current_balance: type: - integer - 'null' description: Amount in minor currency units (for example 2500 means £25.00). purchase_value: type: - integer - 'null' description: Amount in minor currency units (for example 2500 means £25.00). currency: type: string is_monetary: type: boolean allow_part_redeem: type: boolean redemption_status: type: - string - 'null' void: type: boolean void_reason: type: - string - 'null' void_date: type: - string - 'null' format: date-time description: ISO-8601 timestamp. created_at: type: - string - 'null' format: date-time description: ISO-8601 timestamp. updated_at: type: - string - 'null' format: date-time description: ISO-8601 timestamp. required: - id - reference - initial_balance - current_balance - purchase_value - currency - is_monetary - allow_part_redeem - void title: PurchasedVoucher securitySchemes: bearerAuth: type: http description: Bearer token created in the GVB API Access page. scheme: bearer ````