Retrieve a bulk voucher code

Returns a single bulk voucher code.

get

/bulk_voucher_codes/{id}/

Authorizations

AuthorizationstringRequired

Token credential sent in the Authorization header, in the form: Token <your-token>. Requires a staff (admin) account.

Path parameters

idintegerRequired

The unique identifier of the bulk voucher code.

Responses

200

The requested voucher code.

application/json

A bulk voucher code as returned by the API.

pkintegerOptional

Unique voucher code identifier.

codestringOptional

The voucher code value.

basket_offerintegerOptional

Identifier of the parent basket offer.

statusstring · enumOptional

The lifecycle status of a voucher code.

• active — the code can be redeemed; new codes always start here
• passive — the code is disabled
• used — the code has been redeemed and can no longer be updated
• revoked — the code has been withdrawn

Possible values:

userinteger · nullableOptional

Identifier of the user the code is assigned to, when any.

user_emailstring · nullableOptional

Email address of the assigned user, when any.

401

Authentication credentials were not provided or are invalid.

application/json

403

The authenticated user does not have administrator privileges.

application/json

404

The requested bulk voucher code does not exist.

application/json

get/bulk_voucher_codes/{id}/

GET /api/remote/1/bulk_voucher_codes/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "pk": 1041,
  "code": "KOTON9AB3FF76",
  "basket_offer": 35763,
  "status": "active",
  "user": 20518,
  "user_email": "[e-mail]"
}