Skip to main content
GET
List redemption entities

Authorizations

Authorization
string
header
required

Your API key in Authorization: Bearer <key>. Use vk_test_… keys against the sandbox and vk_live_… keys against production.

Query Parameters

page
integer
default:1

Page number, 1-100,000 (default 1). Outside the range: 400 data-failed-validation with the constraint invalid-page.

Required range: 1 <= x <= 100000
perPage
integer
default:25

Items per page, 1-100 (default 25). Outside the range: 400 data-failed-validation with the constraint invalid-page.

Required range: 1 <= x <= 100
sort
string

One sort field; prefix - for descending (sort=field or sort=-field). Allowed: createdAt, refId. Default -createdAt. The server appends id as a tie-breaker.

Example:

"-createdAt"

Case-insensitive search (at most 255 characters) over refId, displayName, email.

Maximum string length: 255
filter[status]
enum<string>

Status (equals).

Available options:
active,
blocked,
erased
filter[status][in]
string

Status (one of (comma-separated)). Comma-separated values.

filter[createdVia]
enum<string>

Creation channel (equals).

Available options:
api,
dashboard,
redemption-link-otp,
import
filter[createdVia][in]
string

Creation channel (one of (comma-separated)). Comma-separated values.

filter[refId]
string

refId (equals).

filter[refId][in]
string

refId (one of (comma-separated)). Comma-separated values.

filter[refId][startsWith]
string

refId (starts with).

filter[refId][isNull]
boolean

refId (is null (true/false)).

filter[email]
string

Email (equals).

filter[createdAt][gt]
string<date-time>

Creation time (download key) (greater than).

filter[createdAt][gte]
string<date-time>

Creation time (download key) (greater than or equal).

filter[createdAt][lt]
string<date-time>

Creation time (download key) (less than).

filter[createdAt][lte]
string<date-time>

Creation time (download key) (less than or equal).

Response

OK

Page envelope of RedemptionEntity items.

data
object
required

The page.