🔒 List vouchers V3

get

https://{xentralId}.xentral.biz/api/v3/vouchers

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: voucher:read.

Paginated list of vouchers. Filter by code to look a single voucher up the way a webshop does - the code is what a customer enters, and remainingAmount is what is left to redeem. Vouchers whose balance is used up are part of the list; filter them out with remainingAmount if you only want the ones that can still be redeemed.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

filter

array of objects

The filter parameter is used to filter the results of the given endpoint.

Supported filter operators by key:

id: equals, notEquals, in, notIn

code: equals, notEquals, in, notIn, contains, notContains, startsWith, endsWith

remainingAmount: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals

issueDate: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals, isNull, isNotNull

validFrom: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals, isNull, isNotNull

expiresAt: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals, isNull, isNotNull

customer.id: equals, notEquals, in, notIn

onlyForCustomer: equals, notEquals

createdAt: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals, isNull, isNotNull

updatedAt: equals, notEquals, lessThan, lessThanOrEquals, greaterThan, greaterThanOrEquals, isNull, isNotNull

filter

sort

array

Sort via id, -id, issueDate, -issueDate, expiresAt, -expiresAt, remainingAmount, -remainingAmount, createdAt, -createdAt, updatedAt and -updatedAt. Default sort is -id

sort

include

array of strings

include

Allowed:

perPage

integer

Number of items per page. Default: 15, Max: 100

page

integer

Page number.

Responses

401

Unauthorized

403

Forbidden

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

429Too Many Requests