Introduction

API for Gift Voucher Brilliance

This documentation aims to provide all the information you need to work with our API.

Base URL

https://admin.giftvoucherbrilliance.co.uk

Authenticating requests

This API is authenticated by sending an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard and clicking API on the menu. If you don't have this feature, please contact support@giftvoucherbrilliance.co.uk.

Order

Return details about the latest orders.

requires authentication

Example request:

curl --request GET \
    --get "https://admin.giftvoucherbrilliance.co.uk/api/orders?page=8&expanded=" \
    --header "Authorization: Bearer {YOUR_AUTH_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://admin.giftvoucherbrilliance.co.uk/api/orders"
);

const params = {
    "page": "8",
    "expanded": "0",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://admin.giftvoucherbrilliance.co.uk/api/orders',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'page'=> '8',
            'expanded'=> '0',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response (200):


{
    "data": {
        "orderNumber": 5,
        "discountCode": "autem",
        "discountTotal": "0",
        "total": 1.46,
        "shippingCost": 2.19,
        "orderDate": null,
        "numVouchers": 1,
        "customer": 5385
    }
}

Received response:

Request failed with error:

Return details about a single order.

requires authentication

Example request:

curl --request GET \
    --get "https://admin.giftvoucherbrilliance.co.uk/api/orders/quibusdam?$order=id&expanded=" \
    --header "Authorization: Bearer {YOUR_AUTH_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://admin.giftvoucherbrilliance.co.uk/api/orders/quibusdam"
);

const params = {
    "$order": "id",
    "expanded": "0",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://admin.giftvoucherbrilliance.co.uk/api/orders/quibusdam',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            '$order'=> 'id',
            'expanded'=> '0',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response (200):


{
    "data": {
        "orderNumber": 6,
        "discountCode": "cum",
        "discountTotal": "0",
        "total": 76.51,
        "shippingCost": 28.45,
        "orderDate": null,
        "numVouchers": 1,
        "customer": 5386
    }
}

Received response:

Request failed with error:

Request

GET api/orders/{order_number}

URL Parameters

order_number string

Query Parameters

$order string

The order ID of the order to return.

expanded boolean optional

Expand related values to full objects e.g return the order with voucher and customer details.

Shop

Endpoints for getting information about the current shop which is decided via the API Token used.

Return details about the current authenicated shop

requires authentication

Example request:

curl --request GET \
    --get "https://admin.giftvoucherbrilliance.co.uk/api/shop" \
    --header "Authorization: Bearer {YOUR_AUTH_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://admin.giftvoucherbrilliance.co.uk/api/shop"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://admin.giftvoucherbrilliance.co.uk/api/shop',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response (200):

Show headers

cache-control: no-cache, private
content-type: application/json
x-ratelimit-limit: 60
x-ratelimit-remaining: 59


{
    "data": {
        "title": "Clockwork",
        "url": "https://clockwork.giftvoucherbrilliance.co.uk"
    }
}

Received response:

Request failed with error:

Voucher

Return details about the latest vouchers issued.

requires authentication

Example request:

curl --request GET \
    --get "https://admin.giftvoucherbrilliance.co.uk/api/vouchers-sold?page=14" \
    --header "Authorization: Bearer {YOUR_AUTH_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://admin.giftvoucherbrilliance.co.uk/api/vouchers-sold"
);

const params = {
    "page": "14",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://admin.giftvoucherbrilliance.co.uk/api/vouchers-sold',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'page'=> '14',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response (200):


{
    "data": {
        "code": "swk-000172-000861",
        "description": "Monetary Vouchers<br/>To the value of &pound;40.00",
        "issuedDate": "2025-07-20 05:50:18",
        "validFromDate": "2025-07-20 05:50:18",
        "expiryDate": "2026-09-14 00:00:00",
        "personalisation": {
            "to": "expedita",
            "message": "Mollitia nemo quas sit doloribus. Doloribus facere cupiditate temporibus voluptatum sunt. Officiis iusto nihil enim et aut."
        },
        "total": 91.12,
        "paid": 91.12,
        "balance": 95.25,
        "status": "Redeemed",
        "customerName": "Duncan Reid",
        "partRedeemable": false,
        "delivery": {
            "method": "Post",
            "type": "Envelope Standard 1st class",
            "cost": 28.51
        }
    }
}

Received response:

Request failed with error:

Return details about a single voucher.

requires authentication

Example request:

curl --request GET \
    --get "https://admin.giftvoucherbrilliance.co.uk/api/vouchers-sold/labore" \
    --header "Authorization: Bearer {YOUR_AUTH_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

const url = new URL(
    "https://admin.giftvoucherbrilliance.co.uk/api/vouchers-sold/labore"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://admin.giftvoucherbrilliance.co.uk/api/vouchers-sold/labore',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response (200):


{
    "data": {
        "code": "gbo-000950-000000",
        "description": "Mud Rasul<br/>2 people (45 mins) &nbsp;",
        "issuedDate": "2025-08-31 01:47:48",
        "validFromDate": "2025-08-31 01:47:48",
        "expiryDate": "2026-07-21 00:00:00",
        "personalisation": {
            "to": "molestias",
            "message": "Et voluptatem illum quia aliquam eum. Autem error aut iure iure sunt perferendis. Ea nulla debitis impedit nemo ut odit rerum. Corporis quibusdam voluptatem nihil et et sit aut."
        },
        "total": 52.35,
        "paid": 52.35,
        "balance": 3.1,
        "status": "Unredeemed",
        "customerName": "Vicky Baker",
        "partRedeemable": false,
        "delivery": {
            "method": "Email",
            "cost": 31.3,
            "email": null
        }
    }
}

Received response:

Request failed with error:

Redeem a voucher.

requires authentication

Example request:

curl --request POST \
    "https://admin.giftvoucherbrilliance.co.uk/api/voucher/quas/redeem" \
    --header "Authorization: Bearer {YOUR_AUTH_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 14
}"

const url = new URL(
    "https://admin.giftvoucherbrilliance.co.uk/api/voucher/quas/redeem"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "amount": 14
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$response = $client->post(
    'https://admin.giftvoucherbrilliance.co.uk/api/voucher/quas/redeem',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'amount' => 14,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response (200):


{
    "data": {
        "code": "fbn-000542-000822",
        "description": "Ultimate Spa Treatment<br/>For Two&nbsp;",
        "issuedDate": "2025-08-04 10:02:54",
        "validFromDate": "2025-08-04 10:02:54",
        "expiryDate": "2026-07-28 00:00:00",
        "personalisation": {
            "to": "qui",
            "message": "Rerum doloribus sapiente possimus atque repudiandae. Occaecati earum quam illum dolor minus. Eos voluptatem adipisci consequatur molestiae aliquid. Placeat reiciendis in et neque."
        },
        "total": 22.42,
        "paid": 22.42,
        "balance": 10.88,
        "status": "Unredeemed",
        "customerName": "Linda Robertson",
        "partRedeemable": false,
        "delivery": {
            "method": "Post",
            "type": "Gift Box Signed 1st class ",
            "cost": 69.34
        }
    }
}

Received response:

Request failed with error:

Request

POST api/voucher/{code_voucher_id}/redeem

URL Parameters

code_voucher_id string

The ID of the code voucher.

code string

The code of the voucher to be redeemed.

Body Parameters

amount integer optional

If the voucher has partRedeemable set to true then you can pass this value. It should be an amount equal or less than the balance of the voucher. The value provided must be of smallest monetary unit of the currency used (integer) e.g £10.43 => 1043.

Introduction

Authenticating requests

Order

Return details about the latest orders.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Query Parameters

Return details about a single order.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

URL Parameters

Query Parameters

Shop

Return details about the current authenicated shop

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Voucher

Return details about the latest vouchers issued.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

Query Parameters

Return details about a single voucher.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

URL Parameters

Redeem a voucher.

Request Try it out ⚡ Cancel 🛑 Send Request 💥

URL Parameters

Body Parameters

Request

Request

Request

Request

Request

Request