NAV Navbar
PHP HTTP Shell JavaScript

REST API v3.0

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

REST API version 3.0 is currently in Beta and is NOT stable. Please use version 2.0^ for production ready applications.

Base URLs:

Email: Support License: Apache 2.0

Authentication

Scope Scope Description
user.read Read your profile information
user.write Update user's profile info
user.instrument.read View user's saved instruments
user.instrument.write Manage user's saved instruments
user.payment.read View user's stored payment card information
user.order.read View user’s completed order information
user.savings_account View user's savings account statistics, cashback balance
user.retailers Manage user's retailer preferences
programme.read View programme information
programme.modules View programme's enabled modules
programme.statistics View programme's dashboard data, milestones, timeline of events
checkout.basket.read View active basket information
checkout.basket.write Update basket by adding or removing items
checkout.payment Make payment on behalf of user
retailers.read View a list of retailers, products and offers supported through SmartSpending™
device.manage Manage registering/unregistering devices for notifications to be sent out
scim.readOnly Read member information on your programme. This will NOT allow the client to write any data.
scim.readWrite Read member information on your programme as well as be able to make changes to Eligibility Listen
user.app.review App review service
notification.read Read members notifications
notification.write Manage notifcations
notification.preferences.read Read members notification preferences
notification.preferences.write Manager members notification preferences
srw.feed.read List the Social Recognition Wall feed
srw.feed.write Add feed items the Social Recognition Wall feed
srw.feed.filter.read Filters on Social Recognition Wall
srw.feed.reaction.read List the Social Recognition Wall feed item reactions
srw.feed.reaction.write React on the Social Recognition Wall feed item
srw.feed.comment.read List the Social Recognition Wall feed item comments
srw.feed.comment.write Comment on the Social Recognition Wall feed item
srw.feed.comment.reply.read List the Social Recognition Wall feed item comment replies
srw.feed.comment.reply.write Reply on the Social Recognition Wall feed item comment
srw.feed.reaction.toolbar.read List the Social Recognition Wall toolbar reactions
srw.ecard.read List the Social Recognition Wall ecard categories within ecards
srw.user.activity.read List user SRW activity
srw.user.stats.read List user SRW statistics
user.hierarchy.read List user hierarchy
user.details.read List user details
user.search Search members
surveys.write Survey Endpoints
programme.create Create a programme
programme.write Write to a programme
programme.admin Manage all programmes
trs.read Read TRS Statements for the user
recognition.external.read Get external recognition form structure.
recognition.external.write Store external recognition details.

Authentication

Authentication Service

Obtain an access token

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/auth/access_token', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/auth/access_token HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/auth/access_token \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "client_id": "string",
  "client_secret": "string",
  "grant_type": "string",
  "username": "string",
  "password": "string",
  "scope": "string",
  "os": "string",
  "os_version": "string",
  "device_manufacturer": "string",
  "device_model": "string",
  "app_name": "string",
  "app_version": "string",
  "device_unique_id": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/auth/access_token',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /auth/access_token

Issues an access token based on supplied credentials

Body parameter

client_id: string
client_secret: string
grant_type: string
username: string
password: string
scope: string
os: string
os_version: string
device_manufacturer: string
device_model: string
app_name: string
app_version: string
device_unique_id: string

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
body body object true none
» client_id body string true Client Id
» client_secret body string true Client Secret
» grant_type body string true Grant type
» username body string true Email address of the member
» password body string true Password of the member
» scope body string true OAuth scope
» os body string false Client OS
» os_version body string false Client OS version
» device_manufacturer body string false Client device manufacturer
» device_model body string false Client device model
» app_name body string false Client app name
» app_version body string false Client app version
» device_unique_id body string false Device Unique ID

Example responses

200 Response

{
  "token_type": "Bearer",
  "expires_in": 600,
  "access_token": "a0b1c2d3e4f5a6b7c8d9...",
  "refresh_token": "a0b1c2d3e4f5a6b7c8d9..."
}

Responses

Status Meaning Description Schema
200 OK Successful operation authResponse
401 Unauthorized Invalid credentials standardModel

Issues an authorization code

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/auth/authorize_code', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/auth/authorize_code?client_id=string&scope=string&response_type=string&redirect_uri=string&state=string HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/auth/authorize_code?client_id=string&scope=string&response_type=string&redirect_uri=string&state=string \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "username": "string",
  "password": "string",
  "grant_type": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/auth/authorize_code?client_id=string&scope=string&response_type=string&redirect_uri=string&state=string',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /auth/authorize_code

Issues an authorization code

Body parameter

username: string
password: string
grant_type: string

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
client_id query string true Client Id
scope query string true Scope
response_type query string true Response Type should always be code
redirect_uri query string true Redirect uri
state query string true State
body body object true none
» username body string true Username
» password body string true Password
» grant_type body string true Grant Type

Example responses

200 Response

{
  "token_type": "Bearer",
  "expires_in": 600,
  "access_token": "a0b1c2d3e4f5a6b7c8d9...",
  "refresh_token": "a0b1c2d3e4f5a6b7c8d9..."
}

Responses

Status Meaning Description Schema
200 OK Successful operation authResponse
400 Bad Request Invalid request standardModel
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Invalid Credentials. Please try again. standardModel

Logs the member out

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/auth/logout', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/auth/logout HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/auth/logout \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/auth/logout',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /auth/logout

Logs the member out

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
204 No Content Successful operation None
403 Forbidden Access has been denied standardModel

Simple test on token validity

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/auth/is_logged_in', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/auth/is_logged_in HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/auth/is_logged_in \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/auth/is_logged_in',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /auth/is_logged_in

Returns 200 OK if still logged in

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning

Example responses

200 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Logged in standardModel
403 Forbidden Not logged in standardModel

Reward Gateway for Small Business

All internal endpoints related to Reward Gateway for Small Businesses

Handle subscription & billing webhook lifecycle events

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Basic cmJfYXV0aDpyYl8ha0pHVGRWZGE3UUVFRVM1QmdsRWJic01oMW9rZ2JlZXM=' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/billing/webhook', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/billing/webhook?v=string&webhookKey=string HTTP/1.1
Host: api.rewardgateway.net

Basic cmJfYXV0aDpyYl8ha0pHVGRWZGE3UUVFRVM1QmdsRWJic01oMW9rZ2JlZXM=: string


# You can also use wget
curl -X POST https://api.rewardgateway.net/billing/webhook?v=string&webhookKey=string \
  -H 'Basic cmJfYXV0aDpyYl8ha0pHVGRWZGE3UUVFRVM1QmdsRWJic01oMW9rZ2JlZXM=: string'



const headers = {
  'Basic cmJfYXV0aDpyYl8ha0pHVGRWZGE3UUVFRVM1QmdsRWJic01oMW9rZ2JlZXM=':'string'
};

fetch('https://api.rewardgateway.net/billing/webhook?v=string&webhookKey=string',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /billing/webhook

Application will handle 3rd lifecycle billing/subscription events

Parameters

Name In Type Required Description
Basic cmJfYXV0aDpyYl8ha0pHVGRWZGE3UUVFRVM1QmdsRWJic01oMW9rZ2JlZXM= header string true Basic cmJfYXV0aDpyYl8ha0pHVGRWZGE3UUVFRVM1QmdsRWJic01oMW9rZ2JlZXM= - above is an example. of basic field not exact for security reasons.
v query string true version of api requested
webhookKey query string true webhook key passed for extra security

Responses

Status Meaning Description Schema
200 OK Successful operation None
400 Bad Request BadRequest - request parameters invalid. None
401 Unauthorized Unauthorized - incorrect parameters passed for authoirisation. None
404 Not Found Invalid Authorisation and/or access request parameters None
500 Internal Server Error Internal server error. None

Returns list of documents for the programme

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/scheme/{schemeId}/comms', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/scheme/{schemeId}/comms HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/scheme/{schemeId}/comms \
  -H 'Accept: application/json' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/{schemeId}/comms',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /scheme/{schemeId}/comms

This endpoint will return you a list of documents related to your programme. i.e. Posters, Flyers etc

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
schemeId path string true scheme id or UUID

Example responses

200 Response

{
  "title": "Discounts Poster",
  "downloadPath": "https://site1.rewardgateway.dev/admin/comms/document/DiscountsPoster",
  "thumbnailPath": "https://static.rewardgateway.dev/BrandAssets/responsive/img/SelfService/admin/comms/discounts-poster.jpg",
  "type": "PDF",
  "buttonText": "Download",
  "category": "Launch"
}

Responses

Status Meaning Description Schema
200 OK Successful operation commsDocument
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme is not found standardModel

New Client onboarding record

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PUT','https://api.rewardgateway.net/onboarding/{uuid}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PUT https://api.rewardgateway.net/onboarding/{uuid} HTTP/1.1
Host: api.rewardgateway.net
Content-Type: application/json
Accept: application/json
Authorization: string


# You can also use wget
curl -X PUT https://api.rewardgateway.net/onboarding/{uuid} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: string'


const inputBody = '{
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "0437819232",
  "email": "john.doe@rewardgateway.com",
  "token": "foo-bar",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "numberOfEmployees": 50,
  "companyRegistrationNumber": "string",
  "streetAddress": "265 Tottenham Court Rd",
  "streetAddressLineTwo": "265 Tottenham Court Rd",
  "city": "London",
  "county": "Greater London",
  "postalCode": "W1T 7RQ",
  "schemeAlias": "companyname.rewardgateway.com",
  "termsAndConditions": "2020-07-14 12:45:00",
  "localeId": "1"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/onboarding/{uuid}',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PUT /onboarding/{uuid}

This endpoint update information for a new RGSB account

Body parameter

{
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "0437819232",
  "email": "john.doe@rewardgateway.com",
  "token": "foo-bar",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "numberOfEmployees": 50,
  "companyRegistrationNumber": "string",
  "streetAddress": "265 Tottenham Court Rd",
  "streetAddressLineTwo": "265 Tottenham Court Rd",
  "city": "London",
  "county": "Greater London",
  "postalCode": "W1T 7RQ",
  "schemeAlias": "companyname.rewardgateway.com",
  "termsAndConditions": "2020-07-14 12:45:00",
  "localeId": "1"
}

firstName: John
lastName: Doe
phoneNumber: "0437819232"
email: john.doe@rewardgateway.com
token: foo-bar
companyName: My Company
companyLegalName: My Company Ltd.
numberOfEmployees: 50
companyRegistrationNumber: string
streetAddress: 265 Tottenham Court Rd
streetAddressLineTwo: 265 Tottenham Court Rd
city: London
county: Greater London
postalCode: W1T 7RQ
schemeAlias: companyname.rewardgateway.com
termsAndConditions: 2020-07-14 12:45:00
localeId: "1"

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
uuid path string true Onboarding member identifier
body body self_service_onboarding false none

Example responses

200 Response

{
  "uuid": "string",
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "0437819232",
  "email": "john.doe@rewardgateway.com",
  "token": "foo-bar",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "numberOfEmployees": 50,
  "companyRegistrationNumber": "string",
  "streetAddress": "265 Tottenham Court Rd",
  "streetAddressLineTwo": "265 Tottenham Court Rd",
  "city": "London",
  "county": "Greater London",
  "postalCode": "W1T 7RQ",
  "schemeAlias": "companyname.rewardgateway.com",
  "termsAndConditions": "2020-07-14 12:45:00",
  "status": "New Prospect",
  "localeId": "1",
  "verificationSentTimes": 1,
  "kycStatus": "string",
  "kycResult": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation self_service_onboarding
400 Bad Request Data validation errors standardModel

Get client onboarding record

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/onboarding/{uuid}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/onboarding/{uuid} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/onboarding/{uuid} \
  -H 'Accept: application/json' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/onboarding/{uuid}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /onboarding/{uuid}

This endpoint get information for RGSB account

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
uuid path string true Onboarding member identifier

Example responses

200 Response

{
  "uuid": "string",
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "0437819232",
  "email": "john.doe@rewardgateway.com",
  "token": "foo-bar",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "numberOfEmployees": 50,
  "companyRegistrationNumber": "string",
  "streetAddress": "265 Tottenham Court Rd",
  "streetAddressLineTwo": "265 Tottenham Court Rd",
  "city": "London",
  "county": "Greater London",
  "postalCode": "W1T 7RQ",
  "schemeAlias": "companyname.rewardgateway.com",
  "termsAndConditions": "2020-07-14 12:45:00",
  "status": "New Prospect",
  "localeId": "1",
  "verificationSentTimes": 1,
  "kycStatus": "string",
  "kycResult": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation self_service_onboarding
400 Bad Request Data validation errors standardModel

Creates a programme

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/scheme', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/scheme HTTP/1.1
Host: api.rewardgateway.net
Content-Type: application/json
Accept: application/json
Authorization: string


# You can also use wget
curl -X POST https://api.rewardgateway.net/scheme \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: string'


const inputBody = '{
  "name": "Reward Hub",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "accountId": "0061j000007EKwDAAW",
  "subAccountId": "0061j000007EKwDAAW",
  "parentAccountId": "0061j000007EKwDAAW",
  "opportunityId": "0061j000007EKwDAAW",
  "emailDomain": "string",
  "schemeType": "rarebreed",
  "localeId": "1",
  "postalCode": "W1T 7RQ",
  "addressLine1": "265 Tottenham Court Rd",
  "addressLine2": "string",
  "addressLine3": "London",
  "addressLine4": "string",
  "companyRegistrationNumber": "string",
  "accountManagerEmail": "account.manager@rewardgateway.com",
  "implementationManagerEmail": "implementation.manager@rewardgateway.com",
  "status": 0,
  "user": {
    "id": "43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "0437819232",
    "email": "john.doe@rewardgateway.com",
    "verificationCode": 123456
  }
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /scheme

This endpoint will allow you to create a brand new programme for use.

Body parameter

{
  "name": "Reward Hub",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "accountId": "0061j000007EKwDAAW",
  "subAccountId": "0061j000007EKwDAAW",
  "parentAccountId": "0061j000007EKwDAAW",
  "opportunityId": "0061j000007EKwDAAW",
  "emailDomain": "string",
  "schemeType": "rarebreed",
  "localeId": "1",
  "postalCode": "W1T 7RQ",
  "addressLine1": "265 Tottenham Court Rd",
  "addressLine2": "string",
  "addressLine3": "London",
  "addressLine4": "string",
  "companyRegistrationNumber": "string",
  "accountManagerEmail": "account.manager@rewardgateway.com",
  "implementationManagerEmail": "implementation.manager@rewardgateway.com",
  "status": 0,
  "user": {
    "id": "43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "0437819232",
    "email": "john.doe@rewardgateway.com",
    "verificationCode": 123456
  }
}

name: Reward Hub
companyName: My Company
companyLegalName: My Company Ltd.
accountId: 0061j000007EKwDAAW
subAccountId: 0061j000007EKwDAAW
parentAccountId: 0061j000007EKwDAAW
opportunityId: 0061j000007EKwDAAW
emailDomain: string
schemeType: rarebreed
localeId: "1"
postalCode: W1T 7RQ
addressLine1: 265 Tottenham Court Rd
addressLine2: string
addressLine3: London
addressLine4: string
companyRegistrationNumber: string
accountManagerEmail: account.manager@rewardgateway.com
implementationManagerEmail: implementation.manager@rewardgateway.com
status: 0
user:
  id: 43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d
  firstName: John
  lastName: Doe
  phoneNumber: "0437819232"
  email: john.doe@rewardgateway.com
  verificationCode: 123456

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
body body self_service_scheme false none

Example responses

200 Response

{
  "id": "string",
  "uuid": "string",
  "name": "Reward Hub",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "accountId": "0061j000007EKwDAAW",
  "subAccountId": "0061j000007EKwDAAW",
  "parentAccountId": "0061j000007EKwDAAW",
  "opportunityId": "0061j000007EKwDAAW",
  "emailDomain": "string",
  "schemeType": "rarebreed",
  "localeId": "1",
  "postalCode": "W1T 7RQ",
  "addressLine1": "265 Tottenham Court Rd",
  "addressLine2": "string",
  "addressLine3": "London",
  "addressLine4": "string",
  "companyRegistrationNumber": "string",
  "accountManagerEmail": "account.manager@rewardgateway.com",
  "implementationManagerEmail": "implementation.manager@rewardgateway.com",
  "status": 0,
  "user": {
    "id": "43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "0437819232",
    "email": "john.doe@rewardgateway.com",
    "verificationCode": 123456
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation self_service_scheme
403 Forbidden Access to the resource has been denied standardModel

Updates programme details

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PUT','https://api.rewardgateway.net/scheme/{schemeId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PUT https://api.rewardgateway.net/scheme/{schemeId} HTTP/1.1
Host: api.rewardgateway.net
Content-Type: application/json
Accept: application/json
Authorization: string


# You can also use wget
curl -X PUT https://api.rewardgateway.net/scheme/{schemeId} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: string'


const inputBody = '{
  "name": "Reward Hub",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "accountId": "0061j000007EKwDAAW",
  "subAccountId": "0061j000007EKwDAAW",
  "parentAccountId": "0061j000007EKwDAAW",
  "opportunityId": "0061j000007EKwDAAW",
  "emailDomain": "string",
  "schemeType": "rarebreed",
  "localeId": "1",
  "postalCode": "W1T 7RQ",
  "addressLine1": "265 Tottenham Court Rd",
  "addressLine2": "string",
  "addressLine3": "London",
  "addressLine4": "string",
  "companyRegistrationNumber": "string",
  "accountManagerEmail": "account.manager@rewardgateway.com",
  "implementationManagerEmail": "implementation.manager@rewardgateway.com",
  "status": 0,
  "user": {
    "id": "43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "0437819232",
    "email": "john.doe@rewardgateway.com",
    "verificationCode": 123456
  }
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/{schemeId}',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PUT /scheme/{schemeId}

This endpoint allows you to update all details related to a programme.

Body parameter

{
  "name": "Reward Hub",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "accountId": "0061j000007EKwDAAW",
  "subAccountId": "0061j000007EKwDAAW",
  "parentAccountId": "0061j000007EKwDAAW",
  "opportunityId": "0061j000007EKwDAAW",
  "emailDomain": "string",
  "schemeType": "rarebreed",
  "localeId": "1",
  "postalCode": "W1T 7RQ",
  "addressLine1": "265 Tottenham Court Rd",
  "addressLine2": "string",
  "addressLine3": "London",
  "addressLine4": "string",
  "companyRegistrationNumber": "string",
  "accountManagerEmail": "account.manager@rewardgateway.com",
  "implementationManagerEmail": "implementation.manager@rewardgateway.com",
  "status": 0,
  "user": {
    "id": "43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "0437819232",
    "email": "john.doe@rewardgateway.com",
    "verificationCode": 123456
  }
}

name: Reward Hub
companyName: My Company
companyLegalName: My Company Ltd.
accountId: 0061j000007EKwDAAW
subAccountId: 0061j000007EKwDAAW
parentAccountId: 0061j000007EKwDAAW
opportunityId: 0061j000007EKwDAAW
emailDomain: string
schemeType: rarebreed
localeId: "1"
postalCode: W1T 7RQ
addressLine1: 265 Tottenham Court Rd
addressLine2: string
addressLine3: London
addressLine4: string
companyRegistrationNumber: string
accountManagerEmail: account.manager@rewardgateway.com
implementationManagerEmail: implementation.manager@rewardgateway.com
status: 0
user:
  id: 43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d
  firstName: John
  lastName: Doe
  phoneNumber: "0437819232"
  email: john.doe@rewardgateway.com
  verificationCode: 123456

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
schemeId path string true scheme id or UUID
body body self_service_scheme false none

Example responses

200 Response

{
  "id": "string",
  "uuid": "string",
  "name": "Reward Hub",
  "companyName": "My Company",
  "companyLegalName": "My Company Ltd.",
  "accountId": "0061j000007EKwDAAW",
  "subAccountId": "0061j000007EKwDAAW",
  "parentAccountId": "0061j000007EKwDAAW",
  "opportunityId": "0061j000007EKwDAAW",
  "emailDomain": "string",
  "schemeType": "rarebreed",
  "localeId": "1",
  "postalCode": "W1T 7RQ",
  "addressLine1": "265 Tottenham Court Rd",
  "addressLine2": "string",
  "addressLine3": "London",
  "addressLine4": "string",
  "companyRegistrationNumber": "string",
  "accountManagerEmail": "account.manager@rewardgateway.com",
  "implementationManagerEmail": "implementation.manager@rewardgateway.com",
  "status": 0,
  "user": {
    "id": "43a0cbfb-f17b-4b8e-9d22-a93b077e8c4d",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "0437819232",
    "email": "john.doe@rewardgateway.com",
    "verificationCode": 123456
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation self_service_scheme
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme is not found standardModel

Replaces programme logo image

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/scheme/{schemeId}/logo', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/scheme/{schemeId}/logo HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string


# You can also use wget
curl -X POST https://api.rewardgateway.net/scheme/{schemeId}/logo \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string'


const inputBody = '{
  "image": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/{schemeId}/logo',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /scheme/{schemeId}/logo

Replaces scheme logo image using binary file in request body. Content-Type header must be correct mime-type or multipart/form-data

Body parameter

image: string

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
schemeId path string true scheme id or UUID
body body object true none
» image body string(binary) true new logo image to replace existing logo

Example responses

200 Response

{
  "imageUrl": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Validation Errors standardModel
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme is not found standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» imageUrl string false none none

Updates scheme colour settings

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PUT','https://api.rewardgateway.net/scheme/{schemeId}/colour', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PUT https://api.rewardgateway.net/scheme/{schemeId}/colour HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string


# You can also use wget
curl -X PUT https://api.rewardgateway.net/scheme/{schemeId}/colour \
  -H 'Accept: application/json' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/{schemeId}/colour',
{
  method: 'PUT',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PUT /scheme/{schemeId}/colour

This endpoint allows you to update programme colors associated with your programme. These are the themese colors used with the site.

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
schemeId path string true scheme id or UUID

Example responses

200 Response

{
  "navigationBackground": "003865",
  "buttonBackground": "003865"
}

Responses

Status Meaning Description Schema
200 OK Successful operation schemeColour
400 Bad Request Validation Errors standardModel
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme is not found standardModel

Re-send members invitations

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PUT','https://api.rewardgateway.net/scheme/{schemeId}/invitations', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PUT https://api.rewardgateway.net/scheme/{schemeId}/invitations HTTP/1.1
Host: api.rewardgateway.net
Content-Type: application/json
Accept: application/json
Authorization: string


# You can also use wget
curl -X PUT https://api.rewardgateway.net/scheme/{schemeId}/invitations \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: string'


const inputBody = '[
  {
    "memberId": "string",
    "resend": true
  }
]';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/{schemeId}/invitations',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PUT /scheme/{schemeId}/invitations

This endpoint allows you to re-sends invitation emails to all currently invited members of the RG for Small Business scheme.

Body parameter

[
  {
    "memberId": "string",
    "resend": true
  }
]

- memberId: string
  resend: true

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
schemeId path string true scheme id or UUID
body body self_service_invitations true List of member uuid and resend flag

Example responses

400 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
400 Bad Request Validation Errors standardModel
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme is not found standardModel

Returns the programme domain

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/scheme/{schemeId}/alias', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/scheme/{schemeId}/alias HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/scheme/{schemeId}/alias \
  -H 'Accept: application/json' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/{schemeId}/alias',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /scheme/{schemeId}/alias

This endpoint will return the domains attached to the programme identifier that is passed.

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
schemeId path integer true none

Example responses

200 Response

{
  "id": "string",
  "hostname": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation self_service_alias
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme or alias is not found standardModel

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PUT','https://api.rewardgateway.net/scheme/{schemeId}/alias', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PUT https://api.rewardgateway.net/scheme/{schemeId}/alias HTTP/1.1
Host: api.rewardgateway.net
Content-Type: application/json
Accept: application/json
Authorization: string


# You can also use wget
curl -X PUT https://api.rewardgateway.net/scheme/{schemeId}/alias \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: string'


const inputBody = '{
  "hostname": "string"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/{schemeId}/alias',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PUT /scheme/{schemeId}/alias

This endpoint will allow you to replace the current domain attached to a programme.

Body parameter

{
  "hostname": "string"
}

hostname: string
Name In Type Required Description
Authorization header string true Valid Bearer access token
schemeId path integer true scheme id
body body self_service_alias false none

Example responses

200 Response

{
  "id": "string",
  "hostname": "string"
}
Status Meaning Description Schema
200 OK Successful operation self_service_alias
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme is not found standardModel

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/scheme/alias', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/scheme/alias?hostname=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/scheme/alias?hostname=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/scheme/alias?hostname=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /scheme/alias

This endpoint will return the preferred domain related if found.

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
hostname query string true Scheme hostname

Example responses

200 Response

{
  "id": "string",
  "hostname": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation self_service_alias
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Scheme alias not found standardModel

Change user password

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PUT','https://api.rewardgateway.net/user/{userId}/password', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PUT https://api.rewardgateway.net/user/{userId}/password HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string


# You can also use wget
curl -X PUT https://api.rewardgateway.net/user/{userId}/password \
  -H 'Accept: application/json' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/user/{userId}/password',
{
  method: 'PUT',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PUT /user/{userId}/password

This endpoint will allow you to change a user's password. Currently only available for RGSB clients.

Parameters

Name In Type Required Description
Authorization header string true Valid Bearer access token
userId path integer true none

Example responses

200 Response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john.smith@acme.com",
  "emailVisible": true,
  "summary": "Ipsum dolor sit amet",
  "timezone": "UK, Western Europe (GMT +1:00)",
  "gender": "X",
  "addressLine1": "123 Some Road",
  "addressLine2": "Floor 4",
  "addressLine3": "London",
  "addressLine4": "London",
  "postalCode": "AA00 0AA",
  "country": "United Kingdom",
  "mobileNumber": "07700900077",
  "mobileNumberVisible": true,
  "telephoneNumber": "02700900077",
  "avatar": "https://www.acme.com/path/to/image.jpg",
  "dateOfBirth": "2019-08-24T14:15:22Z",
  "dateOfBirthVisible": true,
  "registrationDate": "2019-08-24T14:15:22Z",
  "registrationInfo": "Lorem ipsum dolor sit amet",
  "pushNotifications": true,
  "registrationQuestionsAnswers": "string",
  "_links": {
    "self": {
      "href": "/user/me"
    },
    "locale": {
      "href": "/locale/{localeId}"
    },
    "scheme": {
      "href": "/scheme/{schemeId}"
    }
  },
  "_embedded": {
    "locale": {
      "id": 1,
      "name": "GB",
      "lang": "en_GB",
      "currency": "GBP",
      "symbol": "£",
      "states": [
        {
          "code": "ST",
          "name": "State"
        }
      ],
      "contactFields": {
        "firstName": "First Name",
        "lastName": "Surname",
        "emailAddress": "Email Address",
        "mobilePhoneNumber": "Mobile Phone Number",
        "addressLine1": "Address Line 1",
        "addressLine2": "Address Line 2",
        "addressLine3": "Address Line 3",
        "addressLine4": "Address Line 4",
        "postCode": "Postcode"
      },
      "mappings": {
        "locale": "Locale CDN url",
        "fallback": "Fallback locale CDN url"
      },
      "_links": {
        "self": {
          "href": "/locale/{localeId}"
        }
      }
    },
    "scheme": {
      "id": 1234,
      "name": "Acme Rewards",
      "companyName": "Acme Ltd",
      "url": "https://acme.rewardgateway.com",
      "locale": {
        "id": 1,
        "name": "GB",
        "lang": "en_GB",
        "currency": "GBP",
        "symbol": "£",
        "states": [
          {
            "code": "ST",
            "name": "State"
          }
        ],
        "contactFields": {
          "firstName": "First Name",
          "lastName": "Surname",
          "emailAddress": "Email Address",
          "mobilePhoneNumber": "Mobile Phone Number",
          "addressLine1": "Address Line 1",
          "addressLine2": "Address Line 2",
          "addressLine3": "Address Line 3",
          "addressLine4": "Address Line 4",
          "postCode": "Postcode"
        },
        "mappings": {
          "locale": "Locale CDN url",
          "fallback": "Fallback locale CDN url"
        },
        "_links": {
          "self": {
            "href": "/locale/{localeId}"
          }
        }
      },
      "hasUsernameEndpoint": true,
      "team": [
        {
          "fullName": "John Smith",
          "firstName": "John",
          "lastName": "Smith",
          "email": "john.smith@acme.com",
          "cc": [
            "j.smith@acme.com"
          ],
          "image": "https://www.acme.com/path/to/image.jpg",
          "location": "United Kingdom",
          "description": "Lorem ipsum dolor sit amet",
          "role": "Director"
        }
      ],
      "branding": {
        "logo": "https://www.acme.com/path/to/image.jpg",
        "favIcon": "https://www.acme.com/path/to/image.jpg",
        "colours": {
          "navigationBackground": "a1b4c8",
          "navigationText": "a1b4c8",
          "buttonBackground": "a1b4c8",
          "buttonText": "a1b4c8",
          "pageBackground": "a1b4c8",
          "chevronBackground": "a1b4c8",
          "chevronText": "a1b4c8",
          "unselectedTabBackground": "a1b4c8",
          "unselectedTabText": "a1b4c8",
          "selectedTabBackground": "a1b4c8",
          "selectedTabText": "a1b4c8",
          "offersCarouselBackground": "a1b4c8",
          "offersCarouselText": "a1b4c8",
          "registerButtonBackground": "a1b4c8",
          "registerButtonText": "a1b4c8"
        }
      },
      "programmeTypes": [
        {
          "programmeTypeId": 1,
          "programmeTypeName": "Cashback",
          "stateId": 1,
          "stateName": "Enabled"
        }
      ],
      "enabledConfigurations": {
        "FVDining": true
      },
      "_links": {
        "self": {
          "href": "/scheme/{schemeId}"
        },
        "locale": {
          "href": "/locale/{localeId}"
        }
      },
      "_embedded": {
        "locale": {
          "id": 1,
          "name": "GB",
          "lang": "en_GB",
          "currency": "GBP",
          "symbol": "£",
          "states": [
            {
              "code": "ST",
              "name": "State"
            }
          ],
          "contactFields": {
            "firstName": "First Name",
            "lastName": "Surname",
            "emailAddress": "Email Address",
            "mobilePhoneNumber": "Mobile Phone Number",
            "addressLine1": "Address Line 1",
            "addressLine2": "Address Line 2",
            "addressLine3": "Address Line 3",
            "addressLine4": "Address Line 4",
            "postCode": "Postcode"
          },
          "mappings": {
            "locale": "Locale CDN url",
            "fallback": "Fallback locale CDN url"
          },
          "_links": {
            "self": {
              "href": "/locale/{localeId}"
            }
          }
        }
      }
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation member
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied standardModel

Categories

Categories Service

Retailer category details

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/category/{categoryId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/category/{categoryId} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/category/{categoryId} \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/category/{categoryId}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /category/{categoryId}

Returns retailer category details from an identifier

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
categoryId path integer true none

Example responses

200 Response

{
  "id": 123,
  "name": "Reloadable cards",
  "_links": {
    "self": {
      "href": "/category/{categoryId}"
    },
    "hierarchy": {
      "href": "/category/{categoryId}/hierarchy"
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation category
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Retailer category not found standardModel

Retailer category hierarchy

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/category/{categoryId}/hierarchy', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/category/{categoryId}/hierarchy HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/category/{categoryId}/hierarchy \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/category/{categoryId}/hierarchy',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /category/{categoryId}/hierarchy

Returns retailer category hierarchy from an identifier

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
categoryId path integer true none

Example responses

200 Response

{
  "category": {
    "id": 123,
    "name": "Reloadable cards",
    "_links": {
      "self": {
        "href": "/category/{categoryId}"
      },
      "hierarchy": {
        "href": "/category/{categoryId}/hierarchy"
      }
    }
  },
  "parent": {
    "id": 123,
    "name": "Reloadable cards",
    "_links": {
      "self": {
        "href": "/category/{categoryId}"
      },
      "hierarchy": {
        "href": "/category/{categoryId}/hierarchy"
      }
    }
  },
  "children": [
    {
      "id": 123,
      "name": "Reloadable cards",
      "_links": {
        "self": {
          "href": "/category/{categoryId}"
        },
        "hierarchy": {
          "href": "/category/{categoryId}/hierarchy"
        }
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation categoryHierarchy
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied standardModel
404 Not Found Retailer category not found standardModel

Comms Blog Post

All things avaiable around blog posts.

Fetch post details.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/{postId}/details', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/{postId}/details HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/{postId}/details \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/details',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/{postId}/details

Fetch post details.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post origin Id

Example responses

200 Response

{
  "success": true,
  "data": {}
}

Responses

Status Meaning Description Schema
200 OK If post is found. commsPostDetails
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Fetch alerts statuses for post.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/{postId}/alerts', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/{postId}/alerts HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/{postId}/alerts \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/alerts',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/{postId}/alerts

Fetch alerts status for post.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post origin Id

Example responses

200 Response

{
  "success": true,
  "data": {}
}

Responses

Status Meaning Description Schema
200 OK If post if found and user have access. commsPostAlerts
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Fetch post segments explanation

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/{postId}/segment/explanation', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/{postId}/segment/explanation HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/{postId}/segment/explanation \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/segment/explanation',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/{postId}/segment/explanation

Fetch post segments explanation

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post Id

Example responses

200 Response

{
  "success": true,
  "data": {}
}

Responses

Status Meaning Description Schema
200 OK Segments ordering explanation if is found. commsPostDetails
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Fetch versions for post

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/{postId}/version', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/{postId}/version HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/{postId}/version \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/version',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/{postId}/version

Fetch versions for post

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post Id

Example responses

200 Response

{
  "data": [
    {
      "name": "All Users",
      "sort": 3,
      "segment": {
        "id": 2,
        "name": "Do Not Show",
        "query": "Licence ID is"
      },
      "version": {
        "id": 123,
        "title": "New Title",
        "content": "New blog post...",
        "reading_time": "reading_time",
        "is_draft": true
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Segments ordering explanation if is found. commsPostVersionResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Comms Blog

Comms Blog Product.

Get a list of posts based on identifiers

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/bulk/{hash}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/bulk/{hash} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/bulk/{hash} \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/bulk/{hash}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/bulk/{hash}

This endpoint returns a list of blog posts based on identifiers

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
hash path string true Base 64 encoded hash of comma separated list of posts identifiers

Example responses

200 Response

{
  "success": true,
  "data": [
    {
      "id": 198,
      "author": "Joey Tribbiani",
      "dateAdded": "2020-10-15 14:29:07",
      "lastSaved": "2020-10-15 14:29:07",
      "title": "Joye's Pizza",
      "url": "/SmartPage/my-cool-page-198"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation commsContent
403 Forbidden Access to the resource has been denied errorModel

Fetch post history.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/{postId}/history', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/{postId}/history HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/{postId}/history \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/history',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/{postId}/history

Fetch post status history.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post origin Id

Example responses

200 Response

{
  "data": [
    {
      "doerUuid": "8a98e6b3-d51e-4829-a1e2-ed20bbfe248d",
      "doerType": "member",
      "profileUrl": "url",
      "hasProfileUrl": true,
      "isRejectionLink": true,
      "text": "Scheduled by someone.",
      "statusIndex": "scheduled",
      "statusText": "Scheduled",
      "dateElapsed": "2 days ago",
      "rawDate": "2020-07-03T12:36:38+00:00"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK If post history found. commsPostHistory
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Fetch all rejection reasons and meta information.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/{postId}/reject/options', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/{postId}/reject/options HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/{postId}/reject/options \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/reject/options',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/{postId}/reject/options

Fetch all rejection reasons and meta information.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post origin Id

Example responses

200 Response

{
  "success": true,
  "data": {
    "textLimit": "1500",
    "reasons": [
      {
        "value": "1",
        "label": "Too short"
      }
    ]
  }
}

Responses

Status Meaning Description Schema
200 OK If everything is valid. rejectOptionsResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Reject waiting for review post for some reason.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/blog/post/{postId}/reject/fetch/{reasonId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/blog/post/{postId}/reject/fetch/{reasonId} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/blog/post/{postId}/reject/fetch/{reasonId} \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/reject/fetch/{reasonId}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/blog/post/{postId}/reject/fetch/{reasonId}

Reject waiting for review post for some reason.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post origin Id
reasonId path integer true Reason Id

Example responses

200 Response

{
  "success": true,
  "data": [
    {
      "doerUuid": "8a98e6b3-d51e-4829-a1e2-ed20bbfe248d",
      "doerType": "member",
      "profileUrl": "url",
      "avatarUrl": "url",
      "hasProfileUrl": true,
      "isReject": true,
      "text": "Scheduled by someone.",
      "iconType": "cancel",
      "statusIndex": "rejected",
      "statusText": "Rejected",
      "dateElapsed": "2 days ago",
      "rawDate": "2020-07-03T12:36:38+00:00",
      "rejectInfoPath": "/comms/blog/post/200/reject/fetch/11",
      "reasonText": "Add more visual things.",
      "reasonsOptions": [
        "Too short"
      ]
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK If everything is valid. rejectReasonResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Post Segments

Segmentation end-points for post.

Create new version for that post.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/comms/blog/post/{postId}/version', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/comms/blog/post/{postId}/version HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/comms/blog/post/{postId}/version \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/{postId}/version',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /comms/blog/post/{postId}/version

Create new version for that post.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
postId path integer true Post origin Id

Example responses

200 Response

{
  "data": [
    {
      "name": "All Users",
      "sort": 3,
      "segment": {
        "id": 2,
        "name": "Do Not Show",
        "query": "Licence ID is"
      },
      "version": {
        "id": 123,
        "title": "New Title",
        "content": "New blog post...",
        "reading_time": "reading_time",
        "is_draft": true
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK If new version is created. commsPostVersionResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Delete post version

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('DELETE','https://api.rewardgateway.net/comms/blog/post/version/{versionId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


DELETE https://api.rewardgateway.net/comms/blog/post/version/{versionId} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X DELETE https://api.rewardgateway.net/comms/blog/post/version/{versionId} \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/version/{versionId}',
{
  method: 'DELETE',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

DELETE /comms/blog/post/version/{versionId}

Delete post version.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
versionId path integer true Version id

Example responses

200 Response

{
  "data": [
    {
      "name": "All Users",
      "sort": 3,
      "segment": {
        "id": 2,
        "name": "Do Not Show",
        "query": "Licence ID is"
      },
      "version": {
        "id": 123,
        "title": "New Title",
        "content": "New blog post...",
        "reading_time": "reading_time",
        "is_draft": true
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Deleted version as response. commsPostVersionResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Duplicate specific version

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/comms/blog/post/version/{versionId}/duplicate', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/comms/blog/post/version/{versionId}/duplicate HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/comms/blog/post/version/{versionId}/duplicate \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/version/{versionId}/duplicate',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /comms/blog/post/version/{versionId}/duplicate

Duplicate post version.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
versionId path integer true Version id

Example responses

200 Response

{
  "data": [
    {
      "name": "All Users",
      "sort": 3,
      "segment": {
        "id": 2,
        "name": "Do Not Show",
        "query": "Licence ID is"
      },
      "version": {
        "id": 123,
        "title": "New Title",
        "content": "New blog post...",
        "reading_time": "reading_time",
        "is_draft": true
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK All versions commsPostVersionResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Update name of version

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PATCH','https://api.rewardgateway.net/comms/blog/post/version/{versionId}/name', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PATCH https://api.rewardgateway.net/comms/blog/post/version/{versionId}/name HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X PATCH https://api.rewardgateway.net/comms/blog/post/version/{versionId}/name \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "VersionName": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/version/{versionId}/name',
{
  method: 'PATCH',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PATCH /comms/blog/post/version/{versionId}/name

Update name of version

Body parameter

VersionName: string

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
versionId path integer true Version id
body body object true none
» VersionName body string true Json body contains new VersionName

Example responses

200 Response

{
  "data": [
    {
      "name": "All Users",
      "sort": 3,
      "segment": {
        "id": 2,
        "name": "Do Not Show",
        "query": "Licence ID is"
      },
      "version": {
        "id": 123,
        "title": "New Title",
        "content": "New blog post...",
        "reading_time": "reading_time",
        "is_draft": true
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Full version if name was successfully updated. commsPostVersionResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Update segment for version

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PATCH','https://api.rewardgateway.net/comms/blog/post/version/{versionId}/segment', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PATCH https://api.rewardgateway.net/comms/blog/post/version/{versionId}/segment HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X PATCH https://api.rewardgateway.net/comms/blog/post/version/{versionId}/segment \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "SegmentId": 0
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/version/{versionId}/segment',
{
  method: 'PATCH',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PATCH /comms/blog/post/version/{versionId}/segment

Update segment for version

Body parameter

SegmentId: 0

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
versionId path integer true Version id
body body object true none
» SegmentId body integer true Json body contains new VersionName

Example responses

200 Response

{
  "data": [
    {
      "name": "All Users",
      "sort": 3,
      "segment": {
        "id": 2,
        "name": "Do Not Show",
        "query": "Licence ID is"
      },
      "version": {
        "id": 123,
        "title": "New Title",
        "content": "New blog post...",
        "reading_time": "reading_time",
        "is_draft": true
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Version information with new segment. commsPostVersionResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Update order of versions

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PATCH','https://api.rewardgateway.net/comms/blog/post/version/{versionId}/order', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PATCH https://api.rewardgateway.net/comms/blog/post/version/{versionId}/order HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X PATCH https://api.rewardgateway.net/comms/blog/post/version/{versionId}/order \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "position": 0,
  "current": 0
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/blog/post/version/{versionId}/order',
{
  method: 'PATCH',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PATCH /comms/blog/post/version/{versionId}/order

Update order of versions

Body parameter

position: 0
current: 0

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
versionId path integer true Version id
body body object true none
» position body integer true New possition (starting from 1)
» current body integer true Current possition (starting from 1)

Example responses

200 Response

{
  "data": [
    {
      "name": "All Users",
      "sort": 3,
      "segment": {
        "id": 2,
        "name": "Do Not Show",
        "query": "Licence ID is"
      },
      "version": {
        "id": 123,
        "title": "New Title",
        "content": "New blog post...",
        "reading_time": "reading_time",
        "is_draft": true
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK All versions for that post with right order. commsPostVersionResponse
400 Bad Request If some of parameters are not valid. errorModel
401 Unauthorized If current token doesnt have access to that resource. errorModel
404 Not Found Resource was not found. errorModel

Comms SmartPage

Comms SmartPage Product.

Get a list of pages based on identifiers

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/comms/page/bulk/{hash}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/comms/page/bulk/{hash} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/comms/page/bulk/{hash} \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/comms/page/bulk/{hash}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /comms/page/bulk/{hash}

This endpoint returns a list of Smart Page based on identifiers

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
hash path string true Base 64 encoded hash of comma separated list of page identifiers

Example responses

200 Response

{
  "success": true,
  "data": [
    {
      "id": 198,
      "author": "Joey Tribbiani",
      "dateAdded": "2020-10-15 14:29:07",
      "lastSaved": "2020-10-15 14:29:07",
      "title": "Joye's Pizza",
      "url": "/SmartPage/my-cool-page-198"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation commsContent
403 Forbidden Access to the resource has been denied errorModel

Curated

Curated Retailer Lists

Our picks

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/curated/our-picks', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/curated/our-picks HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/curated/our-picks \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/curated/our-picks',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /curated/our-picks

Returns 'Our picks' curated list of retailers

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
page query integer false Page number for paginated collections
limit query integer false Number of items per page for paginated collections

Example responses

200 Response

{
  "page": 1,
  "limit": 20,
  "pages": 10,
  "total": 200,
  "title": "Our Picks",
  "_links": {
    "self": {
      "href": "/curated/our-picks?page=5&limit=20"
    },
    "first": {
      "href": "/curated/our-picks?page=1&limit=20"
    },
    "last": {
      "href": "/curated/our-picks?page=10&limit=20"
    },
    "next": {
      "href": "/curated/our-picks?page=6&limit=20"
    },
    "previous": {
      "href": "/curated/our-picks?page=4&limit=20"
    }
  },
  "_embedded": {
    "retailers": [
      {
        "retailer": {
          "id": 1234,
          "name": "Acme",
          "logo": "https://www.acme.com/path/to/image.jpg",
          "description": "Retailer description for Acme",
          "isFavourite": true,
          "isFeatured": true,
          "category": {
            "id": 123,
            "name": "Reloadable cards",
            "_links": {
              "self": {
                "href": "/category/{categoryId}"
              },
              "hierarchy": {
                "href": "/category/{categoryId}/hierarchy"
              }
            }
          },
          "_links": {
            "self": {
              "href": "/retailer/{retailerId}"
            },
            "offers": {
              "href": "/retailer/{retailerId}/offers"
            }
          }
        },
        "bestOffer": {
          "id": 9999,
          "type": "Cashback",
          "description": "Description for this offer",
          "keyInformation": "Key information for this offer",
          "howItWorks": "Details on how this offer works",
          "termsAndConditions": "Terms & conditions of this offer",
          "expiryDate": "2019-08-24T14:15:22Z",
          "specialOffer": true,
          "redeemableOnDesktop": true,
          "redeemableOnMobile": true,
          "discount": {
            "saving": "Earn 3%",
            "description": "on all offers",
            "useableInStore": true,
            "useableOnline": true,
            "startsOn": "2019-08-24T14:15:22Z",
            "endsOn": "2019-08-24T14:15:22Z"
          },
          "normally": {
            "saving": "Earn 3%",
            "description": "on all offers",
            "useableInStore": true,
            "useableOnline": true,
            "startsOn": "2019-08-24T14:15:22Z",
            "endsOn": "2019-08-24T14:15:22Z"
          },
          "_links": {
            "self": {
              "href": "/offer/{offerId}"
            }
          }
        }
      }
    ]
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
401 Unauthorized Access token expired standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» page integer(int32) true none none
» limit integer(int32) true none none
» pages integer(int32) true none none
» total integer(int32) true none none
» title string true none none
» _links object false none none
»» self object false none none
»»» href string false none Endpoint to access the current page of results
»» first object false none none
»»» href string false none Endpoint to access the first page of results
»» last object false none none
»»» href string false none Endpoint to access the last page of results
»» next object false none none
»»» href string false none Endpoint to access the next page of results
»» previous object false none none
»»» href string false none Endpoint to access the previous page of results
» _embedded object true none none
»» retailers [retailerDetails] false none none
»»» retailer object true none none
»»»» id integer(int32) true none Retailer identifier
»»»» name string true none Retailer's name
»»»» logo string true none Retailer's logo (URL)
»»»» description string true none Retailer's description
»»»» isFavourite boolean true none Is retailer favourited
»»»» isFeatured boolean true none Is retailer featured
»»»» category object false none none
»»»»» id integer(int32) true none Category identifier
»»»»» name string true none Category name
»»»»» _links object false none none
»»»»»» self object false none none
»»»»»»» href string false none Endpoint to access this resource
»»»»»» hierarchy object false none none
»»»»»»» href string false none Endpoint to retrieve category hierarchy
»»»» _links object false none none
»»»»» self object false none none
»»»»»» href string false none Endpoint to access this resource
»»»»» offers object false none none
»»»»»» href string false none Endpoint to retrieve all retailer's offers
»»» bestOffer object true none none
»»»» id integer(int32) true none Offer identifier
»»»» type string true none Type of the offer
»»»» description string true none Offer's description
»»»» keyInformation string true none Offer's key information
»»»» howItWorks string true none How the offer works
»»»» termsAndConditions string true none Offer's terms and conditions
»»»» expiryDate string(date-time) true none Offer's expiry date
»»»» specialOffer boolean true none Is this a special offer?
»»»» redeemableOnDesktop boolean true none Offer can be redeemed on the desktop
»»»» redeemableOnMobile boolean true none Offer can be redeemed on mobile
»»»» discount object true none none
»»»»» saving string true none Discount savings
»»»»» description string true none Discount description
»»»»» useableInStore boolean true none Discount can be used in-store
»»»»» useableOnline boolean true none Discount can be used online
»»»»» startsOn string(date-time) true none Discount is valid from
»»»»» endsOn string(date-time) true none Discount is valid until
»»»» normally object false none none
»»»» _links object false none none
»»»»» self object false none none
»»»»»» href string false none Endpoint to access this resource

This week is all about

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/curated/this-week', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/curated/this-week HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/curated/this-week \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/curated/this-week',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /curated/this-week

Returns 'This week is all about' curated list of retailers

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
page query integer false Page number for paginated collections
limit query integer false Number of items per page for paginated collections

Example responses

200 Response

{
  "page": 1,
  "limit": 20,
  "pages": 10,
  "total": 200,
  "title": "This week is all about",
  "_links": {
    "self": {
      "href": "/curated/this-week?page=5&limit=20"
    },
    "first": {
      "href": "/curated/this-week?page=1&limit=20"
    },
    "last": {
      "href": "/curated/this-week?page=10&limit=20"
    },
    "next": {
      "href": "/curated/this-week?page=6&limit=20"
    },
    "previous": {
      "href": "/curated/this-week?page=4&limit=20"
    }
  },
  "_embedded": {
    "retailers": [
      {
        "retailer": {
          "id": 1234,
          "name": "Acme",
          "logo": "https://www.acme.com/path/to/image.jpg",
          "description": "Retailer description for Acme",
          "isFavourite": true,
          "isFeatured": true,
          "category": {
            "id": 123,
            "name": "Reloadable cards",
            "_links": {
              "self": {
                "href": "/category/{categoryId}"
              },
              "hierarchy": {
                "href": "/category/{categoryId}/hierarchy"
              }
            }
          },
          "_links": {
            "self": {
              "href": "/retailer/{retailerId}"
            },
            "offers": {
              "href": "/retailer/{retailerId}/offers"
            }
          }
        },
        "bestOffer": {
          "id": 9999,
          "type": "Cashback",
          "description": "Description for this offer",
          "keyInformation": "Key information for this offer",
          "howItWorks": "Details on how this offer works",
          "termsAndConditions": "Terms & conditions of this offer",
          "expiryDate": "2019-08-24T14:15:22Z",
          "specialOffer": true,
          "redeemableOnDesktop": true,
          "redeemableOnMobile": true,
          "discount": {
            "saving": "Earn 3%",
            "description": "on all offers",
            "useableInStore": true,
            "useableOnline": true,
            "startsOn": "2019-08-24T14:15:22Z",
            "endsOn": "2019-08-24T14:15:22Z"
          },
          "normally": {
            "saving": "Earn 3%",
            "description": "on all offers",
            "useableInStore": true,
            "useableOnline": true,
            "startsOn": "2019-08-24T14:15:22Z",
            "endsOn": "2019-08-24T14:15:22Z"
          },
          "_links": {
            "self": {
              "href": "/offer/{offerId}"
            }
          }
        }
      }
    ]
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
401 Unauthorized Access token expired standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» page integer(int32) true none none
» limit integer(int32) true none none
» pages integer(int32) true none none
» total integer(int32) true none none
» title string true none none
» _links object false none none
»» self object false none none
»»» href string false none Endpoint to access the current page of results
»» first object false none none
»»» href string false none Endpoint to access the first page of results
»» last object false none none
»»» href string false none Endpoint to access the last page of results
»» next object false none none
»»» href string false none Endpoint to access the next page of results
»» previous object false none none
»»» href string false none Endpoint to access the previous page of results
» _embedded object true none none
»» retailers [retailerDetails] false none none
»»» retailer object true none none
»»»» id integer(int32) true none Retailer identifier
»»»» name string true none Retailer's name
»»»» logo string true none Retailer's logo (URL)
»»»» description string true none Retailer's description
»»»» isFavourite boolean true none Is retailer favourited
»»»» isFeatured boolean true none Is retailer featured
»»»» category object false none none
»»»»» id integer(int32) true none Category identifier
»»»»» name string true none Category name
»»»»» _links object false none none
»»»»»» self object false none none
»»»»»»» href string false none Endpoint to access this resource
»»»»»» hierarchy object false none none
»»»»»»» href string false none Endpoint to retrieve category hierarchy
»»»» _links object false none none
»»»»» self object false none none
»»»»»» href string false none Endpoint to access this resource
»»»»» offers object false none none
»»»»»» href string false none Endpoint to retrieve all retailer's offers
»»» bestOffer object true none none
»»»» id integer(int32) true none Offer identifier
»»»» type string true none Type of the offer
»»»» description string true none Offer's description
»»»» keyInformation string true none Offer's key information
»»»» howItWorks string true none How the offer works
»»»» termsAndConditions string true none Offer's terms and conditions
»»»» expiryDate string(date-time) true none Offer's expiry date
»»»» specialOffer boolean true none Is this a special offer?
»»»» redeemableOnDesktop boolean true none Offer can be redeemed on the desktop
»»»» redeemableOnMobile boolean true none Offer can be redeemed on mobile
»»»» discount object true none none
»»»»» saving string true none Discount savings
»»»»» description string true none Discount description
»»»»» useableInStore boolean true none Discount can be used in-store
»»»»» useableOnline boolean true none Discount can be used online
»»»»» startsOn string(date-time) true none Discount is valid from
»»»»» endsOn string(date-time) true none Discount is valid until
»»»» normally object false none none
»»»» _links object false none none
»»»»» self object false none none
»»»»»» href string false none Endpoint to access this resource

Helpers

Helper Services

Sends one-time passcode to member

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/helpers/mail-otp', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/helpers/mail-otp HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/helpers/mail-otp \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "username": "string",
  "clientId": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/mail-otp',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /helpers/mail-otp

This endpoint will send an One-time passcode to a member. This maybe used for verification purposes.

Body parameter

username: string
clientId: string

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
body body object true none
» username body string true Member identifier
» clientId body string true Identifier of client connecting to the API

Example responses

200 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation standardModel
400 Bad Request Required parameters in request are missing/invalid standardModel
401 Unauthorized Access token expired standardModel
403 Forbidden Access denied standardModel
404 Not Found Member/programme not found standardModel
429 Too Many Requests Too many requests standardModel

Expire access token

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/helpers/expire-accesstoken', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/helpers/expire-accesstoken HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X POST https://api.rewardgateway.net/helpers/expire-accesstoken \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/helpers/expire-accesstoken',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /helpers/expire-accesstoken

Mark access token as expired

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token

Example responses

401 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
204 No Content Successful operation None
401 Unauthorized Access token expired standardModel

Returns the current api and app version for os

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/helpers/versions', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/helpers/versions?os=string&clientId=string&locale=0 HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/helpers/versions?os=string&clientId=string&locale=0 \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/versions?os=string&clientId=string&locale=0',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /helpers/versions

This endpoint returns the current minimum supported api versions for your client id.

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
os query string true Operating system one of os or android
clientId query string true Identifier of client connecting to the API
locale query integer true Locale identifier

Example responses

200 Response

{
  "appVersion": "1.2.3",
  "apiVersion": "1.2.3"
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Required parameters in request are missing/invalid standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» appVersion string false none none
» apiVersion string false none none

Is app version supported

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/helpers/version-supported', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/helpers/version-supported?clientId=string&appVersion=string&os=string&locale=0 HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/helpers/version-supported?clientId=string&appVersion=string&os=string&locale=0 \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/version-supported?clientId=string&appVersion=string&os=string&locale=0',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /helpers/version-supported

Check if the provided app version is supported

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
clientId query string true Identifier of client connecting to the API
appVersion query string true App version
os query string true Operating system one of os or android
locale query integer true Locale identifier

Example responses

200 Response

{
  "supported": true
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Required parameters in request are missing/invalid standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» supported boolean false none none

Find programmes by email address

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/helpers/lookup-scheme', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/helpers/lookup-scheme?username=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/helpers/lookup-scheme?username=string \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/lookup-scheme?username=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /helpers/lookup-scheme

Find a list of programmes that an email is registered on

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
username query string true Email address of the member
clientId query string false Identifier of client connecting to the API

Example responses

200 Response

[
  {
    "member": {
      "id": "00000000-0000-0000-0000-000000000000",
      "email": "user@acme.com",
      "_links": {
        "self": {
          "href": "/helper/lookup/scheme?username={memberEmail}"
        }
      }
    },
    "scheme": {
      "id": 1234,
      "name": "Acme Rewards",
      "companyName": "Acme Ltd",
      "url": "http://acme.rewardgateway.com",
      "hasUsernameEndpoint": true,
      "branding": {
        "logo": "https://www.acme.com/path/to/image.jpg",
        "favIcon": "https://www.acme.com/path/to/image.jpg",
        "colours": {
          "navigationBackground": "a1b4c8",
          "navigationText": "a1b4c8",
          "buttonBackground": "a1b4c8",
          "buttonText": "a1b4c8",
          "pageBackground": "a1b4c8",
          "chevronBackground": "a1b4c8",
          "chevronText": "a1b4c8",
          "unselectedTabBackground": "a1b4c8",
          "unselectedTabText": "a1b4c8",
          "selectedTabBackground": "a1b4c8",
          "selectedTabText": "a1b4c8",
          "offersCarouselBackground": "a1b4c8",
          "offersCarouselText": "a1b4c8",
          "registerButtonBackground": "a1b4c8",
          "registerButtonText": "a1b4c8"
        }
      },
      "_links": {
        "self": {
          "href": "/scheme/{schemeId}"
        }
      }
    },
    "locale": {
      "id": 1,
      "_links": {
        "self": {
          "href": "/locale/{localeId}"
        }
      }
    }
  }
]

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Required parameters in request are missing/invalid standardModel
401 Unauthorized Access token expired standardModel
404 Not Found Member/programme not found standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [simplifiedResponse] false none none
» member object true none none
»» id string true none Member identifier
»» email string true none Member email
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource
» scheme object true none none
»» id integer(int32) true none Programme identifier
»» name string true none Programme name
»» companyName string true none Programme company
»» url string true none Programme URL
»» hasUsernameEndpoint boolean true none Programme has username endpoint
»» branding object false none none
»»» logo string true none Programme's logo
»»» favIcon string true none Programme's favourite icon
»»» colours object false none none
»»»» navigationBackground string true none Navigation background colour
»»»» navigationText string true none Navigation text colour
»»»» buttonBackground string false none Button background colour
»»»» buttonText string false none Button text colour
»»»» pageBackground string false none Page background colour
»»»» chevronBackground string false none Chevron background colour
»»»» chevronText string false none Chevron text colour
»»»» unselectedTabBackground string false none Unselected tab background colour
»»»» unselectedTabText string false none Unselected tab text colour
»»»» selectedTabBackground string false none Selected tab background colour
»»»» selectedTabText string false none Selected tab text colour
»»»» offersCarouselBackground string false none Offers caroussel background colour
»»»» offersCarouselText string false none Offers caroussel text colour
»»»» registerButtonBackground string false none Register button background colour
»»»» registerButtonText string false none Register button text colour
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource
» locale object true none none
»» id integer(int32) true none Locale identifier
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource

Get programme information from given domain

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/helpers/lookup-scheme-alias', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/helpers/lookup-scheme-alias?alias=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/helpers/lookup-scheme-alias?alias=string \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/lookup-scheme-alias?alias=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /helpers/lookup-scheme-alias

This endpoint searches for the domain provided and returns the related programme information if there is a match.

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
alias query string true Scheme Alias

Example responses

200 Response

{
  "id": 1234,
  "name": "Acme Rewards",
  "companyName": "Acme Ltd",
  "url": "https://acme.rewardgateway.com",
  "locale": {
    "id": 1,
    "name": "GB",
    "lang": "en_GB",
    "currency": "GBP",
    "symbol": "£",
    "states": [
      {
        "code": "ST",
        "name": "State"
      }
    ],
    "contactFields": {
      "firstName": "First Name",
      "lastName": "Surname",
      "emailAddress": "Email Address",
      "mobilePhoneNumber": "Mobile Phone Number",
      "addressLine1": "Address Line 1",
      "addressLine2": "Address Line 2",
      "addressLine3": "Address Line 3",
      "addressLine4": "Address Line 4",
      "postCode": "Postcode"
    },
    "mappings": {
      "locale": "Locale CDN url",
      "fallback": "Fallback locale CDN url"
    },
    "_links": {
      "self": {
        "href": "/locale/{localeId}"
      }
    }
  },
  "hasUsernameEndpoint": true,
  "team": [
    {
      "fullName": "John Smith",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.smith@acme.com",
      "cc": [
        "j.smith@acme.com"
      ],
      "image": "https://www.acme.com/path/to/image.jpg",
      "location": "United Kingdom",
      "description": "Lorem ipsum dolor sit amet",
      "role": "Director"
    }
  ],
  "branding": {
    "logo": "https://www.acme.com/path/to/image.jpg",
    "favIcon": "https://www.acme.com/path/to/image.jpg",
    "colours": {
      "navigationBackground": "a1b4c8",
      "navigationText": "a1b4c8",
      "buttonBackground": "a1b4c8",
      "buttonText": "a1b4c8",
      "pageBackground": "a1b4c8",
      "chevronBackground": "a1b4c8",
      "chevronText": "a1b4c8",
      "unselectedTabBackground": "a1b4c8",
      "unselectedTabText": "a1b4c8",
      "selectedTabBackground": "a1b4c8",
      "selectedTabText": "a1b4c8",
      "offersCarouselBackground": "a1b4c8",
      "offersCarouselText": "a1b4c8",
      "registerButtonBackground": "a1b4c8",
      "registerButtonText": "a1b4c8"
    }
  },
  "programmeTypes": [
    {
      "programmeTypeId": 1,
      "programmeTypeName": "Cashback",
      "stateId": 1,
      "stateName": "Enabled"
    }
  ],
  "enabledConfigurations": {
    "FVDining": true
  },
  "_links": {
    "self": {
      "href": "/scheme/{schemeId}"
    },
    "locale": {
      "href": "/locale/{localeId}"
    }
  },
  "_embedded": {
    "locale": {
      "id": 1,
      "name": "GB",
      "lang": "en_GB",
      "currency": "GBP",
      "symbol": "£",
      "states": [
        {
          "code": "ST",
          "name": "State"
        }
      ],
      "contactFields": {
        "firstName": "First Name",
        "lastName": "Surname",
        "emailAddress": "Email Address",
        "mobilePhoneNumber": "Mobile Phone Number",
        "addressLine1": "Address Line 1",
        "addressLine2": "Address Line 2",
        "addressLine3": "Address Line 3",
        "addressLine4": "Address Line 4",
        "postCode": "Postcode"
      },
      "mappings": {
        "locale": "Locale CDN url",
        "fallback": "Fallback locale CDN url"
      },
      "_links": {
        "self": {
          "href": "/locale/{localeId}"
        }
      }
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation scheme
400 Bad Request Required parameters in request are missing/invalid standardModel
401 Unauthorized Access token expired standardModel
404 Not Found No scheme alias match standardModel

Get description of all oAuth 2.0 scopes

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/helpers/lookup-scopes', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/helpers/lookup-scopes?scopes=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/helpers/lookup-scopes?scopes=string \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/lookup-scopes?scopes=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /helpers/lookup-scopes

This endpoint will return a list of all scopes used within the application and descriptions of what each does.

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
scopes query string true Scopes, separated by spaces

Example responses

200 Response

{
  "scope1": "Scope 1 description",
  "scopeN": "Scope N description"
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Required parameters in request are missing/invalid standardModel
401 Unauthorized Access token expired standardModel
404 Not Found Could not match any valid scopes to describe standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» scope1 string false none The description for the first scope
» scopeN string false none The description for the n-th scope

Get description for the client

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/helpers/lookup-client', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/helpers/lookup-client?clientId=string&schemeId=0 HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/helpers/lookup-client?clientId=string&schemeId=0 \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/lookup-client?clientId=string&schemeId=0',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /helpers/lookup-client

Get more information and description for the client id

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
clientId query string true Client identifier
schemeId query integer true Programme identifier

Example responses

200 Response

{
  "client": {
    "id": "client_identifier",
    "name": "Acme Integration",
    "logo": "https://www.acme.com/path/to/image.jpg",
    "description": "Lorem ipsum dolor sit amet",
    "privacyUrl": "https://www.acme.com/privacy",
    "termsUrl": "https://www.acme.com/terms-and-conditions"
  },
  "scheme": {
    "id": 1234,
    "name": "Acme Rewards",
    "companyName": "Acme Ltd",
    "url": "https://acme.rewardgateway.com",
    "locale": {
      "id": 1,
      "name": "GB",
      "lang": "en_GB",
      "currency": "GBP",
      "symbol": "£",
      "states": [
        {
          "code": "ST",
          "name": "State"
        }
      ],
      "contactFields": {
        "firstName": "First Name",
        "lastName": "Surname",
        "emailAddress": "Email Address",
        "mobilePhoneNumber": "Mobile Phone Number",
        "addressLine1": "Address Line 1",
        "addressLine2": "Address Line 2",
        "addressLine3": "Address Line 3",
        "addressLine4": "Address Line 4",
        "postCode": "Postcode"
      },
      "mappings": {
        "locale": "Locale CDN url",
        "fallback": "Fallback locale CDN url"
      },
      "_links": {
        "self": {
          "href": "/locale/{localeId}"
        }
      }
    },
    "hasUsernameEndpoint": true,
    "team": [
      {
        "fullName": "John Smith",
        "firstName": "John",
        "lastName": "Smith",
        "email": "john.smith@acme.com",
        "cc": [
          "j.smith@acme.com"
        ],
        "image": "https://www.acme.com/path/to/image.jpg",
        "location": "United Kingdom",
        "description": "Lorem ipsum dolor sit amet",
        "role": "Director"
      }
    ],
    "branding": {
      "logo": "https://www.acme.com/path/to/image.jpg",
      "favIcon": "https://www.acme.com/path/to/image.jpg",
      "colours": {
        "navigationBackground": "a1b4c8",
        "navigationText": "a1b4c8",
        "buttonBackground": "a1b4c8",
        "buttonText": "a1b4c8",
        "pageBackground": "a1b4c8",
        "chevronBackground": "a1b4c8",
        "chevronText": "a1b4c8",
        "unselectedTabBackground": "a1b4c8",
        "unselectedTabText": "a1b4c8",
        "selectedTabBackground": "a1b4c8",
        "selectedTabText": "a1b4c8",
        "offersCarouselBackground": "a1b4c8",
        "offersCarouselText": "a1b4c8",
        "registerButtonBackground": "a1b4c8",
        "registerButtonText": "a1b4c8"
      }
    },
    "programmeTypes": [
      {
        "programmeTypeId": 1,
        "programmeTypeName": "Cashback",
        "stateId": 1,
        "stateName": "Enabled"
      }
    ],
    "enabledConfigurations": {
      "FVDining": true
    },
    "_links": {
      "self": {
        "href": "/scheme/{schemeId}"
      },
      "locale": {
        "href": "/locale/{localeId}"
      }
    },
    "_embedded": {
      "locale": {
        "id": 1,
        "name": "GB",
        "lang": "en_GB",
        "currency": "GBP",
        "symbol": "£",
        "states": [
          {
            "code": "ST",
            "name": "State"
          }
        ],
        "contactFields": {
          "firstName": "First Name",
          "lastName": "Surname",
          "emailAddress": "Email Address",
          "mobilePhoneNumber": "Mobile Phone Number",
          "addressLine1": "Address Line 1",
          "addressLine2": "Address Line 2",
          "addressLine3": "Address Line 3",
          "addressLine4": "Address Line 4",
          "postCode": "Postcode"
        },
        "mappings": {
          "locale": "Locale CDN url",
          "fallback": "Fallback locale CDN url"
        },
        "_links": {
          "self": {
            "href": "/locale/{localeId}"
          }
        }
      }
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Required parameters in request are missing/invalid standardModel
401 Unauthorized Access token expired standardModel
403 Forbidden This api integration is currently disabled standardModel
404 Not Found Could not match any valid clients to describe standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» client object false none none
»» id string true none Client identifier
»» name string true none Client name
»» logo string true none Client logo
»» description string true none Client description
»» privacyUrl string true none Client's privacy URL
»» termsUrl string true none Client's terms and conditions URL
» scheme object false none none
»» id integer(int32) true none Programme identifier
»» name string true none Programme name
»» companyName string true none Programme company name
»» url string true none Programme URL
»» locale object true none none
»»» id integer(int32) true none Locale identifier
»»» name string true none Locale name
»»» lang string true none Locale language
»»» currency string true none Locale currency
»»» symbol string true none Locale currency symbol
»»» states [state] true none Locale state list
»»»» code string true none State code
»»»» name string true none State name
»»» contactFields object true none List of translated contact fields
»»»» firstName any false none List of translated contact fields
»»»» lastName any false none List of translated contact fields
»»»» emailAddress any false none List of translated contact fields
»»»» mobilePhoneNumber any false none List of translated contact fields
»»»» addressLine1 any false none List of translated contact fields
»»»» addressLine2 any false none List of translated contact fields
»»»» addressLine3 any false none List of translated contact fields
»»»» addressLine4 any false none List of translated contact fields
»»»» postCode any false none List of translated contact fields
»»» mappings object false none Mappings to download jsons for React apps
»»»» locale string false none Mappings to download jsons for React apps
»»»» fallback string false none Mappings to download jsons for React apps
»»» _links object false none none
»»»» self object false none none
»»»»» href string false none Endpoint to access this resource
»» hasUsernameEndpoint boolean true none Programme's username endpoint
»» team [teamMembers] true none Programme's team
»»» fullName string true none none
»»» firstName string true none none
»»» lastName string true none none
»»» email string true none none
»»» cc [string] true none none
»»» image string true none none
»»» location string true none none
»»» description string true none none
»»» role string true none none
»» branding object true none none
»»» logo string true none Programme's logo
»»» favIcon string true none Programme's favourite icon
»»» colours object false none none
»»»» navigationBackground string true none Navigation background colour
»»»» navigationText string true none Navigation text colour
»»»» buttonBackground string false none Button background colour
»»»» buttonText string false none Button text colour
»»»» pageBackground string false none Page background colour
»»»» chevronBackground string false none Chevron background colour
»»»» chevronText string false none Chevron text colour
»»»» unselectedTabBackground string false none Unselected tab background colour
»»»» unselectedTabText string false none Unselected tab text colour
»»»» selectedTabBackground string false none Selected tab background colour
»»»» selectedTabText string false none Selected tab text colour
»»»» offersCarouselBackground string false none Offers caroussel background colour
»»»» offersCarouselText string false none Offers caroussel text colour
»»»» registerButtonBackground string false none Register button background colour
»»»» registerButtonText string false none Register button text colour
»» programmeTypes [any] true none Programme types for the scheme
»»» programmeTypeId integer(int32) false none Programme types for the scheme
»»» programmeTypeName string false none Programme types for the scheme
»»» stateId integer(int32) false none Programme types for the scheme
»»» stateName string false none Programme types for the scheme
»» enabledConfigurations object false none Programme configurations enabled
»»» FVDining boolean false none Programme configurations enabled
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource
»»» locale object false none none
»»»» href string false none Endpoint to access this programme's locale
»» _embedded object false none none
»»» locale object false none none

Get programme information from given uuid

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/helpers/lookup-scheme-uuid', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/helpers/lookup-scheme-uuid?schemeUuid=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/helpers/lookup-scheme-uuid?schemeUuid=string \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/helpers/lookup-scheme-uuid?schemeUuid=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /helpers/lookup-scheme-uuid

This endpoint searches for the uuid provided and returns the related programme information if there is a match.

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
schemeUuid query string true Scheme Uuid

Example responses

200 Response

{
  "id": 1234,
  "name": "Acme Rewards",
  "companyName": "Acme Ltd",
  "url": "https://acme.rewardgateway.com",
  "locale": {
    "id": 1,
    "name": "GB",
    "lang": "en_GB",
    "currency": "GBP",
    "symbol": "£",
    "states": [
      {
        "code": "ST",
        "name": "State"
      }
    ],
    "contactFields": {
      "firstName": "First Name",
      "lastName": "Surname",
      "emailAddress": "Email Address",
      "mobilePhoneNumber": "Mobile Phone Number",
      "addressLine1": "Address Line 1",
      "addressLine2": "Address Line 2",
      "addressLine3": "Address Line 3",
      "addressLine4": "Address Line 4",
      "postCode": "Postcode"
    },
    "mappings": {
      "locale": "Locale CDN url",
      "fallback": "Fallback locale CDN url"
    },
    "_links": {
      "self": {
        "href": "/locale/{localeId}"
      }
    }
  },
  "hasUsernameEndpoint": true,
  "team": [
    {
      "fullName": "John Smith",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.smith@acme.com",
      "cc": [
        "j.smith@acme.com"
      ],
      "image": "https://www.acme.com/path/to/image.jpg",
      "location": "United Kingdom",
      "description": "Lorem ipsum dolor sit amet",
      "role": "Director"
    }
  ],
  "branding": {
    "logo": "https://www.acme.com/path/to/image.jpg",
    "favIcon": "https://www.acme.com/path/to/image.jpg",
    "colours": {
      "navigationBackground": "a1b4c8",
      "navigationText": "a1b4c8",
      "buttonBackground": "a1b4c8",
      "buttonText": "a1b4c8",
      "pageBackground": "a1b4c8",
      "chevronBackground": "a1b4c8",
      "chevronText": "a1b4c8",
      "unselectedTabBackground": "a1b4c8",
      "unselectedTabText": "a1b4c8",
      "selectedTabBackground": "a1b4c8",
      "selectedTabText": "a1b4c8",
      "offersCarouselBackground": "a1b4c8",
      "offersCarouselText": "a1b4c8",
      "registerButtonBackground": "a1b4c8",
      "registerButtonText": "a1b4c8"
    }
  },
  "programmeTypes": [
    {
      "programmeTypeId": 1,
      "programmeTypeName": "Cashback",
      "stateId": 1,
      "stateName": "Enabled"
    }
  ],
  "enabledConfigurations": {
    "FVDining": true
  },
  "_links": {
    "self": {
      "href": "/scheme/{schemeId}"
    },
    "locale": {
      "href": "/locale/{localeId}"
    }
  },
  "_embedded": {
    "locale": {
      "id": 1,
      "name": "GB",
      "lang": "en_GB",
      "currency": "GBP",
      "symbol": "£",
      "states": [
        {
          "code": "ST",
          "name": "State"
        }
      ],
      "contactFields": {
        "firstName": "First Name",
        "lastName": "Surname",
        "emailAddress": "Email Address",
        "mobilePhoneNumber": "Mobile Phone Number",
        "addressLine1": "Address Line 1",
        "addressLine2": "Address Line 2",
        "addressLine3": "Address Line 3",
        "addressLine4": "Address Line 4",
        "postCode": "Postcode"
      },
      "mappings": {
        "locale": "Locale CDN url",
        "fallback": "Fallback locale CDN url"
      },
      "_links": {
        "self": {
          "href": "/locale/{localeId}"
        }
      }
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation scheme
400 Bad Request Required parameters in request are missing/invalid standardModel
404 Not Found No scheme uuid match standardModel

Offers

Offers Service

Offer details

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/offer/{offerId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/offer/{offerId} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/offer/{offerId} \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/offer/{offerId}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /offer/{offerId}

Returns offer details from an identifier

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
offerId path integer true none

Example responses

200 Response

{
  "id": 9999,
  "type": "Cashback",
  "description": "Description for this offer",
  "keyInformation": "Key information for this offer",
  "howItWorks": "Details on how this offer works",
  "termsAndConditions": "Terms & conditions of this offer",
  "expiryDate": "2019-08-24T14:15:22Z",
  "specialOffer": true,
  "redeemableOnDesktop": true,
  "redeemableOnMobile": true,
  "discount": {
    "saving": "Earn 3%",
    "description": "on all offers",
    "useableInStore": true,
    "useableOnline": true,
    "startsOn": "2019-08-24T14:15:22Z",
    "endsOn": "2019-08-24T14:15:22Z"
  },
  "normally": {
    "saving": "Earn 3%",
    "description": "on all offers",
    "useableInStore": true,
    "useableOnline": true,
    "startsOn": "2019-08-24T14:15:22Z",
    "endsOn": "2019-08-24T14:15:22Z"
  },
  "_links": {
    "self": {
      "href": "/offer/{offerId}"
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation offer
401 Unauthorized Access token expired standardModel
403 Forbidden Offer not available standardModel
404 Not Found Offer not found standardModel

List all offers from Retailer

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/retailer/{retailerId}/offers', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/retailer/{retailerId}/offers HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/retailer/{retailerId}/offers \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/retailer/{retailerId}/offers',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /retailer/{retailerId}/offers

Returns retailer offers from an identifier

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
retailerId path integer true none

Example responses

200 Response

{
  "retailer": {
    "id": 1234,
    "name": "Acme",
    "logo": "https://www.acme.com/path/to/image.jpg",
    "description": "Retailer description for Acme",
    "isFavourite": true,
    "isFeatured": true,
    "category": {
      "id": 123,
      "name": "Reloadable cards",
      "_links": {
        "self": {
          "href": "/category/{categoryId}"
        },
        "hierarchy": {
          "href": "/category/{categoryId}/hierarchy"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/retailer/{retailerId}"
      },
      "offers": {
        "href": "/retailer/{retailerId}/offers"
      }
    }
  },
  "offers": [
    {
      "id": 9999,
      "type": "Cashback",
      "description": "Description for this offer",
      "keyInformation": "Key information for this offer",
      "howItWorks": "Details on how this offer works",
      "termsAndConditions": "Terms & conditions of this offer",
      "expiryDate": "2019-08-24T14:15:22Z",
      "specialOffer": true,
      "redeemableOnDesktop": true,
      "redeemableOnMobile": true,
      "discount": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "normally": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "_links": {
        "self": {
          "href": "/offer/{offerId}"
        }
      }
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation retailerOffers
401 Unauthorized Access token expired standardModel
403 Forbidden Retailer not available standardModel
404 Not Found Retailer not found standardModel

Promotions

Retailer Promotions Service

Deal of the Week promotion

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/promotions/deal-of-the-week', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/promotions/deal-of-the-week HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/promotions/deal-of-the-week \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/promotions/deal-of-the-week',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /promotions/deal-of-the-week

Returns deal of the week promotion

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token

Example responses

200 Response

{
  "banner": {
    "image": "https://www.acme.com/path/to/image.jpg",
    "title": "Title of this banner",
    "subtitle": "Subtitle of this banner",
    "endsOn": "2019-08-24T14:15:22Z"
  },
  "retailer": {
    "id": 1234,
    "name": "Acme",
    "logo": "https://www.acme.com/path/to/image.jpg",
    "description": "Retailer description for Acme",
    "isFavourite": true,
    "isFeatured": true,
    "category": {
      "id": 123,
      "name": "Reloadable cards",
      "_links": {
        "self": {
          "href": "/category/{categoryId}"
        },
        "hierarchy": {
          "href": "/category/{categoryId}/hierarchy"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/retailer/{retailerId}"
      },
      "offers": {
        "href": "/retailer/{retailerId}/offers"
      }
    }
  },
  "offer": {
    "id": 9999,
    "type": "Cashback",
    "description": "Description for this offer",
    "keyInformation": "Key information for this offer",
    "howItWorks": "Details on how this offer works",
    "termsAndConditions": "Terms & conditions of this offer",
    "expiryDate": "2019-08-24T14:15:22Z",
    "specialOffer": true,
    "redeemableOnDesktop": true,
    "redeemableOnMobile": true,
    "discount": {
      "saving": "Earn 3%",
      "description": "on all offers",
      "useableInStore": true,
      "useableOnline": true,
      "startsOn": "2019-08-24T14:15:22Z",
      "endsOn": "2019-08-24T14:15:22Z"
    },
    "normally": {
      "saving": "Earn 3%",
      "description": "on all offers",
      "useableInStore": true,
      "useableOnline": true,
      "startsOn": "2019-08-24T14:15:22Z",
      "endsOn": "2019-08-24T14:15:22Z"
    },
    "_links": {
      "self": {
        "href": "/offer/{offerId}"
      }
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation promotion
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied standardModel

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/promotions/featured-retailers', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/promotions/featured-retailers HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/promotions/featured-retailers \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/promotions/featured-retailers',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /promotions/featured-retailers

Returns featured retailer promotions

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token

Example responses

200 Response

[
  {
    "banner": {
      "image": "https://www.acme.com/path/to/image.jpg",
      "title": "Title of this banner",
      "subtitle": "Subtitle of this banner",
      "endsOn": "2019-08-24T14:15:22Z"
    },
    "retailer": {
      "id": 1234,
      "name": "Acme",
      "logo": "https://www.acme.com/path/to/image.jpg",
      "description": "Retailer description for Acme",
      "isFavourite": true,
      "isFeatured": true,
      "category": {
        "id": 123,
        "name": "Reloadable cards",
        "_links": {
          "self": {
            "href": "/category/{categoryId}"
          },
          "hierarchy": {
            "href": "/category/{categoryId}/hierarchy"
          }
        }
      },
      "_links": {
        "self": {
          "href": "/retailer/{retailerId}"
        },
        "offers": {
          "href": "/retailer/{retailerId}/offers"
        }
      }
    },
    "offer": {
      "id": 9999,
      "type": "Cashback",
      "description": "Description for this offer",
      "keyInformation": "Key information for this offer",
      "howItWorks": "Details on how this offer works",
      "termsAndConditions": "Terms & conditions of this offer",
      "expiryDate": "2019-08-24T14:15:22Z",
      "specialOffer": true,
      "redeemableOnDesktop": true,
      "redeemableOnMobile": true,
      "discount": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "normally": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "_links": {
        "self": {
          "href": "/offer/{offerId}"
        }
      }
    }
  }
]
Status Meaning Description Schema
200 OK Successful operation Inline
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied standardModel

Status Code 200

Name Type Required Restrictions Description
anonymous [promotion] false none none
» banner object true none none
»» image string true none Banner image location (URL)
»» title string true none Banner title
»» subtitle string true none Banner subtitle
»» endsOn string(date-time) true none Banner ends on date
» retailer object true none none
»» id integer(int32) true none Retailer identifier
»» name string true none Retailer's name
»» logo string true none Retailer's logo (URL)
»» description string true none Retailer's description
»» isFavourite boolean true none Is retailer favourited
»» isFeatured boolean true none Is retailer featured
»» category object false none none
»»» id integer(int32) true none Category identifier
»»» name string true none Category name
»»» _links object false none none
»»»» self object false none none
»»»»» href string false none Endpoint to access this resource
»»»» hierarchy object false none none
»»»»» href string false none Endpoint to retrieve category hierarchy
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource
»»» offers object false none none
»»»» href string false none Endpoint to retrieve all retailer's offers
» offer object true none none
»» id integer(int32) true none Offer identifier
»» type string true none Type of the offer
»» description string true none Offer's description
»» keyInformation string true none Offer's key information
»» howItWorks string true none How the offer works
»» termsAndConditions string true none Offer's terms and conditions
»» expiryDate string(date-time) true none Offer's expiry date
»» specialOffer boolean true none Is this a special offer?
»» redeemableOnDesktop boolean true none Offer can be redeemed on the desktop
»» redeemableOnMobile boolean true none Offer can be redeemed on mobile
»» discount object true none none
»»» saving string true none Discount savings
»»» description string true none Discount description
»»» useableInStore boolean true none Discount can be used in-store
»»» useableOnline boolean true none Discount can be used online
»»» startsOn string(date-time) true none Discount is valid from
»»» endsOn string(date-time) true none Discount is valid until
»» normally object false none none
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource

Top Offers promotions

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/promotions/top-offers', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/promotions/top-offers HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/promotions/top-offers \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/promotions/top-offers',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /promotions/top-offers

Returns top offers promotions

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
limit query integer false Number of items per page for paginated collections

Example responses

200 Response

[
  {
    "banner": {
      "image": "https://www.acme.com/path/to/image.jpg",
      "title": "Title of this banner",
      "subtitle": "Subtitle of this banner",
      "endsOn": "2019-08-24T14:15:22Z"
    },
    "retailer": {
      "id": 1234,
      "name": "Acme",
      "logo": "https://www.acme.com/path/to/image.jpg",
      "description": "Retailer description for Acme",
      "isFavourite": true,
      "isFeatured": true,
      "category": {
        "id": 123,
        "name": "Reloadable cards",
        "_links": {
          "self": {
            "href": "/category/{categoryId}"
          },
          "hierarchy": {
            "href": "/category/{categoryId}/hierarchy"
          }
        }
      },
      "_links": {
        "self": {
          "href": "/retailer/{retailerId}"
        },
        "offers": {
          "href": "/retailer/{retailerId}/offers"
        }
      }
    },
    "offer": {
      "id": 9999,
      "type": "Cashback",
      "description": "Description for this offer",
      "keyInformation": "Key information for this offer",
      "howItWorks": "Details on how this offer works",
      "termsAndConditions": "Terms & conditions of this offer",
      "expiryDate": "2019-08-24T14:15:22Z",
      "specialOffer": true,
      "redeemableOnDesktop": true,
      "redeemableOnMobile": true,
      "discount": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "normally": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "_links": {
        "self": {
          "href": "/offer/{offerId}"
        }
      }
    }
  }
]

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [promotion] false none none
» banner object true none none
»» image string true none Banner image location (URL)
»» title string true none Banner title
»» subtitle string true none Banner subtitle
»» endsOn string(date-time) true none Banner ends on date
» retailer object true none none
»» id integer(int32) true none Retailer identifier
»» name string true none Retailer's name
»» logo string true none Retailer's logo (URL)
»» description string true none Retailer's description
»» isFavourite boolean true none Is retailer favourited
»» isFeatured boolean true none Is retailer featured
»» category object false none none
»»» id integer(int32) true none Category identifier
»»» name string true none Category name
»»» _links object false none none
»»»» self object false none none
»»»»» href string false none Endpoint to access this resource
»»»» hierarchy object false none none
»»»»» href string false none Endpoint to retrieve category hierarchy
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource
»»» offers object false none none
»»»» href string false none Endpoint to retrieve all retailer's offers
» offer object true none none
»» id integer(int32) true none Offer identifier
»» type string true none Type of the offer
»» description string true none Offer's description
»» keyInformation string true none Offer's key information
»» howItWorks string true none How the offer works
»» termsAndConditions string true none Offer's terms and conditions
»» expiryDate string(date-time) true none Offer's expiry date
»» specialOffer boolean true none Is this a special offer?
»» redeemableOnDesktop boolean true none Offer can be redeemed on the desktop
»» redeemableOnMobile boolean true none Offer can be redeemed on mobile
»» discount object true none none
»»» saving string true none Discount savings
»»» description string true none Discount description
»»» useableInStore boolean true none Discount can be used in-store
»»» useableOnline boolean true none Discount can be used online
»»» startsOn string(date-time) true none Discount is valid from
»»» endsOn string(date-time) true none Discount is valid until
»» normally object false none none
»» _links object false none none
»»» self object false none none
»»»» href string false none Endpoint to access this resource

Recognition & Reward

All endpoints related to our Recognition & Reward product. This will allow you to send out recognition to other users as well as see what recognition moments each users has received etc.

Get a member's alternate approvers configuration

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/config', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/config HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/config \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/config',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/member/{memberUuid}/alternateApprovers/config

This endpoint will return information about a member's alternate approvers configuration

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
memberUuid path string true Member identifier

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Get a member's alternate approvers list

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/member/{memberUuid}/alternateApprovers

This endpoint will return information about a member's alternate approvers

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
memberUuid path string true Member identifier

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Create alternate approver for a member

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers HTTP/1.1
Host: api.rewardgateway.net
Content-Type: application/json
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "approverContactIds": [
    null
  ],
  "startDate": "string",
  "endDate": "string"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /recognition/member/{memberUuid}/alternateApprovers

This endpoint will create an alternate approver item for a member

Body parameter

{
  "approverContactIds": [
    null
  ],
  "startDate": "string",
  "endDate": "string"
}

approverContactIds:
  - null
startDate: string
endDate: string

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
memberUuid path string true Member identifier
body body object true none

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Update alternate approver for a member

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('PUT','https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


PUT https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId} HTTP/1.1
Host: api.rewardgateway.net
Content-Type: application/json
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X PUT https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "approverContactIds": [
    null
  ],
  "startDate": "string",
  "endDate": "string"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId}',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

PUT /recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId}

This endpoint will update an alternate approver item for a member

Body parameter

{
  "approverContactIds": [
    null
  ],
  "startDate": "string",
  "endDate": "string"
}

approverContactIds:
  - null
startDate: string
endDate: string

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
memberUuid path string true Member identifier
alternateApproverItemId path integer true Alternate approver item identifer
body body object true none

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Delete a member's alternate approvers

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('DELETE','https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


DELETE https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X DELETE https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId} \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId}',
{
  method: 'DELETE',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

DELETE /recognition/member/{memberUuid}/alternateApprovers/{alternateApproverItemId}

This endpoint will delete a member's alternate approvers

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
memberUuid path string true Member identifier
alternateApproverItemId path integer true Alternate approver item identifer

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Get a member's recognition award

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid} \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/member/{memberUuid}/award/{nomineeUuid}

This endpoint will return information about a member's award

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
memberUuid path string true Member identifier
nomineeUuid path string true Nominee identifier

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Claim a member's recognition award

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid}/claim', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid}/claim HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid}/claim \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/{memberUuid}/award/{nomineeUuid}/claim',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/member/{memberUuid}/award/{nomineeUuid}/claim

This endpoint will claim a member's award

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
memberUuid path string true Member identifier
nomineeUuid path string true Nominee identifier

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Get the current member's recognition

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/member/awards', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/member/awards?identifier=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/member/awards?identifier=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/member/awards?identifier=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/member/awards

This endpoint will return a list of all monetary recognition the current member has received. These maybe claimed by the member or unclaimed in some cases.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
identifier query string true Member identifier
offset query string false Pagination offset
limit query string false Pagination limit

Example responses

403 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied standardModel

Give me all types of recognition the authenticated user can send

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/categories', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/categories HTTP/1.1
Host: api.rewardgateway.net

Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/categories \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/categories',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/categories

This endpoint will return information about rrSchemes that can be use by member

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning

Responses

Status Meaning Description Schema
200 OK Successful operation None

Display additional information about nomination programme

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/categories/info', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/categories/info?rrSchemeId=string HTTP/1.1
Host: api.rewardgateway.net

Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/categories/info?rrSchemeId=string \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/categories/info?rrSchemeId=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/categories/info

Display additional information about nomination programme

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
rrSchemeId query string true rr scheme id

Responses

Status Meaning Description Schema
200 OK Successful operation None

Show who can receive specified recognition

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/categories/recipients', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/categories/recipients HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data

Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/categories/recipients \
  -H 'Content-Type: multipart/form-data' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "recipients": "string",
  "rrSchemeId": "string",
  "rrType": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/categories/recipients',
{
  method: 'GET',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/categories/recipients

Returns a list of eligible and ineligible members to receive recognition

Body parameter

recipients: string
rrSchemeId: string
rrType: string

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
body body object true none
» recipients body string true List of recipients uuid seperated by comma
» rrSchemeId body string true rr scheme id
» rrType body string true rr recognition Type

Responses

Status Meaning Description Schema
200 OK Successful operation None

Send a non-monetary recognition moment

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/ecard', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/ecard HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/ecard \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "cardId": 0,
  "categoryId": 0,
  "message": "string",
  "form": "string",
  "recipients": "string",
  "shared": 0
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/ecard',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /ecard

This endpoint will send a non-monetary recognition moment (eCard) on behalf of the current user.

Body parameter

cardId: 0
categoryId: 0
message: string
form: string
recipients: string
shared: 0

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
body body object true none
» cardId body integer true eCard identifier
» categoryId body integer true Category identifier
» message body string true Ecard message
» form body string true Request is send from [android,ios]
» recipients body string true List of recipients
» shared body integer false eCard is shared

Example responses

200 Response

{
  "id": 1234,
  "name": "Acme Rewards",
  "companyName": "Acme Ltd",
  "url": "https://acme.rewardgateway.com",
  "locale": {
    "id": 1,
    "name": "GB",
    "lang": "en_GB",
    "currency": "GBP",
    "symbol": "£",
    "states": [
      {
        "code": "ST",
        "name": "State"
      }
    ],
    "contactFields": {
      "firstName": "First Name",
      "lastName": "Surname",
      "emailAddress": "Email Address",
      "mobilePhoneNumber": "Mobile Phone Number",
      "addressLine1": "Address Line 1",
      "addressLine2": "Address Line 2",
      "addressLine3": "Address Line 3",
      "addressLine4": "Address Line 4",
      "postCode": "Postcode"
    },
    "mappings": {
      "locale": "Locale CDN url",
      "fallback": "Fallback locale CDN url"
    },
    "_links": {
      "self": {
        "href": "/locale/{localeId}"
      }
    }
  },
  "hasUsernameEndpoint": true,
  "team": [
    {
      "fullName": "John Smith",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.smith@acme.com",
      "cc": [
        "j.smith@acme.com"
      ],
      "image": "https://www.acme.com/path/to/image.jpg",
      "location": "United Kingdom",
      "description": "Lorem ipsum dolor sit amet",
      "role": "Director"
    }
  ],
  "branding": {
    "logo": "https://www.acme.com/path/to/image.jpg",
    "favIcon": "https://www.acme.com/path/to/image.jpg",
    "colours": {
      "navigationBackground": "a1b4c8",
      "navigationText": "a1b4c8",
      "buttonBackground": "a1b4c8",
      "buttonText": "a1b4c8",
      "pageBackground": "a1b4c8",
      "chevronBackground": "a1b4c8",
      "chevronText": "a1b4c8",
      "unselectedTabBackground": "a1b4c8",
      "unselectedTabText": "a1b4c8",
      "selectedTabBackground": "a1b4c8",
      "selectedTabText": "a1b4c8",
      "offersCarouselBackground": "a1b4c8",
      "offersCarouselText": "a1b4c8",
      "registerButtonBackground": "a1b4c8",
      "registerButtonText": "a1b4c8"
    }
  },
  "programmeTypes": [
    {
      "programmeTypeId": 1,
      "programmeTypeName": "Cashback",
      "stateId": 1,
      "stateName": "Enabled"
    }
  ],
  "enabledConfigurations": {
    "FVDining": true
  },
  "_links": {
    "self": {
      "href": "/scheme/{schemeId}"
    },
    "locale": {
      "href": "/locale/{localeId}"
    }
  },
  "_embedded": {
    "locale": {
      "id": 1,
      "name": "GB",
      "lang": "en_GB",
      "currency": "GBP",
      "symbol": "£",
      "states": [
        {
          "code": "ST",
          "name": "State"
        }
      ],
      "contactFields": {
        "firstName": "First Name",
        "lastName": "Surname",
        "emailAddress": "Email Address",
        "mobilePhoneNumber": "Mobile Phone Number",
        "addressLine1": "Address Line 1",
        "addressLine2": "Address Line 2",
        "addressLine3": "Address Line 3",
        "addressLine4": "Address Line 4",
        "postCode": "Postcode"
      },
      "mappings": {
        "locale": "Locale CDN url",
        "fallback": "Fallback locale CDN url"
      },
      "_links": {
        "self": {
          "href": "/locale/{localeId}"
        }
      }
    }
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation scheme
400 Bad Request Bad request errorModel
403 Forbidden Access to the resource has been denied errorModel
404 Not Found Scheme is not found errorModel

Add product to basket

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/recognition/redemption/basket', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/recognition/redemption/basket HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/recognition/redemption/basket \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/basket',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /recognition/redemption/basket

This endpoint adds a product to R&R basket

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning

Example responses

403 Response

{
  "code": 0,
  "message": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied errorModel

Get categories for scheme

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/physical/categories', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/physical/categories?type=string&departmentId=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/physical/categories?type=string&departmentId=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/categories?type=string&departmentId=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/physical/categories

This endpoint returns a list of R&R redemption categories for the selected physical store

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon
departmentId query string true The id of the department that we want to show the categories for

Example responses

200 Response

[
  {
    "searchIndex": "HomeAndKitchen",
    "name": "Home & Kitchen",
    "logo": "https://static.rewardgateway.dev/BrandAssets/responsive/img/rr-redemption-assets/category-icon-homekitchen.svg"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Bad request errorModel
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied errorModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [physicalCategory] false none none
» searchIndex string true none The searchIndex name given to the category
» name string true none The name of the category
» logo string true none An image logo for the category

Get all physical items in the shopping basket

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/physical/basket', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/physical/basket?type=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/physical/basket?type=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/basket?type=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/physical/basket

This endpoint will return all items the current member has in their shopping basket.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon
basketId query string false Basket identifier

Example responses

200 Response

{
  "basketId": "string",
  "currency": "string",
  "total": 0,
  "subtotal": 0,
  "saving": 0,
  "items": [
    {
      "id": 0,
      "type": "string",
      "productId": 0,
      "productType": "string",
      "name": "string",
      "image": "string",
      "currency": "string",
      "price": 0,
      "cost": 0,
      "tax": 0,
      "saving": 0,
      "quantity": 0,
      "termsAndConditions": "string",
      "adjustments": [
        null
      ]
    }
  ],
  "messages": [
    null
  ]
}

Responses

Status Meaning Description Schema
200 OK Successful operation basket
403 Forbidden Access to the resource has been denied errorModel
404 Not Found Basket was not found errorModel

Add physical product to basket

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/recognition/redemption/physical/basket', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/recognition/redemption/physical/basket HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/recognition/redemption/physical/basket \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "type": "string",
  "productCode": "string",
  "quantity": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/basket',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /recognition/redemption/physical/basket

This endpoint adds a physical product to the basket

Body parameter

type: string
productCode: string
quantity: string

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
body body object true none
» type body string true Physical store type e.g. amazon
» productCode body string true The product code of the item that we would like added to the basket
» quantity body string false The quantity of the product that we want in the basket. Default value of 1 will be used if no value is provided

Example responses

403 Response

{
  "code": 0,
  "message": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied errorModel
404 Not Found Basket was not found. errorModel

Clear the physical shopping basket

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('DELETE','https://api.rewardgateway.net/recognition/redemption/physical/basket', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


DELETE https://api.rewardgateway.net/recognition/redemption/physical/basket?type=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X DELETE https://api.rewardgateway.net/recognition/redemption/physical/basket?type=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/basket?type=string',
{
  method: 'DELETE',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

DELETE /recognition/redemption/physical/basket

This endpoint will clear all items currently available in the current member's shopping basket.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon

Example responses

200 Response

{
  "code": 1234,
  "message": "Example message",
  "details": [
    "Example details"
  ]
}

Responses

Status Meaning Description Schema
200 OK Basket emptied successfully standardModel
403 Forbidden Access to the resource has been denied errorModel
404 Not Found Basket was not found errorModel

Remove physical product from basket

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('DELETE','https://api.rewardgateway.net/recognition/redemption/physical/basket/{productCode}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


DELETE https://api.rewardgateway.net/recognition/redemption/physical/basket/{productCode}?type=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X DELETE https://api.rewardgateway.net/recognition/redemption/physical/basket/{productCode}?type=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/basket/{productCode}?type=string',
{
  method: 'DELETE',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

DELETE /recognition/redemption/physical/basket/{productCode}

This endpoint removes a physical product from the basket

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
productCode path string true The product code of the item that we would like removed from the basket
type query string true Physical store type e.g. amazon

Example responses

403 Response

{
  "code": 0,
  "message": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied errorModel
404 Not Found Basket or Product was not found. errorModel

Get top rated items

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/physical/categories/topRated', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/physical/categories/topRated?type=string&category=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/physical/categories/topRated?type=string&category=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/categories/topRated?type=string&category=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/physical/categories/topRated

This endpoint returns top rated items

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon
category query string true The the category to get the results for, e.g. fashion

Example responses

200 Response

{
  "name": "New Releases"
}

Responses

Status Meaning Description Schema
200 OK Successful operation physicalProductCollection
400 Bad Request Bad request errorModel
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied errorModel

Get new releases items

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/physical/categories/newReleases', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/physical/categories/newReleases?type=string&category=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/physical/categories/newReleases?type=string&category=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/categories/newReleases?type=string&category=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/physical/categories/newReleases

This endpoint returns new releases items

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon
category query string true The the category to get the results for, e.g. fashion

Example responses

200 Response

{
  "name": "New Releases"
}

Responses

Status Meaning Description Schema
200 OK Successful operation physicalProductCollection
400 Bad Request Bad request errorModel
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied errorModel

Get best sellers items

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/physical/categories/bestSellers', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/physical/categories/bestSellers?type=string&category=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/physical/categories/bestSellers?type=string&category=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/categories/bestSellers?type=string&category=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/physical/categories/bestSellers

This endpoint returns best sellers items

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon
category query string true The the category to get the results for, e.g. fashion

Example responses

200 Response

{
  "name": "New Releases"
}

Responses

Status Meaning Description Schema
200 OK Successful operation physicalProductCollection
400 Bad Request Bad request errorModel
401 Unauthorized Access token expired standardModel
403 Forbidden Access to the resource has been denied errorModel

Get departments for scheme

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/physical/departments', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/physical/departments?type=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/physical/departments?type=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/departments?type=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/physical/departments

This endpoint returns a list of R&R redemption departments for the selected physical store

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon

Example responses

200 Response

[
  {
    "id": 1,
    "name": "Films, TV, Music & Games",
    "logo": "https://static.rewardgateway.dev/BrandAssets/responsive/img/rr-redemption-assets/department-icon-films.svg",
    "categories": [
      {
        "searchIndex": "HomeAndKitchen",
        "name": "Home & Kitchen",
        "logo": "https://static.rewardgateway.dev/BrandAssets/responsive/img/rr-redemption-assets/category-icon-homekitchen.svg"
      }
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Bad request errorModel
403 Forbidden Access to the resource has been denied errorModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [physicalDepartment] false none none
» id integer true none An id reference given to a department
» name string true none The name of the departmnent
» logo string true none An image logo for the department
» categories [physicalCategory] false none Categories
»» searchIndex string true none The searchIndex name given to the category
»» name string true none The name of the category
»» logo string true none An image logo for the category

Disburse a client's funds to a thirdparty e.g. amazon

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/recognition/redemption/physical/fundsDisbursement', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/recognition/redemption/physical/fundsDisbursement HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/recognition/redemption/physical/fundsDisbursement \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "type": "string",
  "externalCustomerId": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/fundsDisbursement',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /recognition/redemption/physical/fundsDisbursement

This endpoint will disburse funds from a clients balance to the selected physical store of a thirdparty e.g. amazon

Body parameter

type: string
externalCustomerId: string

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
body body object true none
» type body string true Physical store type e.g. amazon
» externalCustomerId body string true Unique customer account identifier for the external store

Example responses

200 Response

[
  {
    "code": 1234,
    "message": "Example message",
    "details": [
      "Example details"
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Bad request errorModel
403 Forbidden Access to the resource has been denied errorModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [standardModel] false none none
» code integer(int32) true none none
» message string true none none
» details [string] true none none

Get product by product code

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/physical/product', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/physical/product?type=string&productCode=string HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/physical/product?type=string&productCode=string \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/physical/product?type=string&productCode=string',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/physical/product

This endpoint returns a R&R redemption product for the given product code and selected physical store

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
type query string true Physical store type e.g. amazon
productCode query string true The code of the product to retrieve data for

Example responses

200 Response

[
  {
    "productCode": "B07PFQNPKW",
    "productName": "Huawei P30 128 GB 6.1 Inch OLED Display Smartphone with Leica Triple Camera, 6GB RAM, EMUI 9.1.0 Sim-Free Android Mobile Phone, Single SIM, Aurora, UK Version",
    "reviewCount": 917,
    "reviewRating": 4.6,
    "images": [
      {
        "small": "https://m.media-amazon.com/images/I/51DNLdrMg4L._SL75_.jpg",
        "medium": "https://m.media-amazon.com/images/I/51DNLdrMg4L._SL160_.jpg",
        "large": "https://m.media-amazon.com/images/I/51DNLdrMg4L.jpg"
      }
    ],
    "value": {
      "currency": "£20",
      "points": "200 Points"
    },
    "previousValue": {
      "currency": "£20",
      "points": "200 Points"
    },
    "savingPercentage": 32,
    "productSummary": [
      "Single SIM slot"
    ],
    "productDetails": [
      {
        "name": "Color",
        "value": "Black"
      }
    ],
    "availability": {
      "message": "In stock",
      "minOrderQuantity": 1,
      "maxOrderQuantity": 10
    }
  }
]

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
400 Bad Request Bad request errorModel
403 Forbidden Access to the resource has been denied errorModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [physicalProduct] false none none
» productCode string true none A reference to the product
» productName string true none The name/title given to a product
» reviewCount integer false none The number of reviews that there are on a product
» reviewRating number(float) false none The review rating of a product
» images [physicalImages] true none Images
»» small string true none The url path to a small dimension of the image
»» medium string true none The url path to a medium dimension of the image
»» large string true none The url path to a large dimension of the image
» value object true none none
»» currency string true none The value of the product in currency format
»» points string true none The value of the product in points
» previousValue object false none none
» savingPercentage integer false none The percentage of saving that the product has been reduced in value by
» productSummary [string] false none The product summary
» productDetails [physicalProductAttributes] false none ProductDetails
»» name string true none The value given to the attribute
»» value string true none The value given to the attribute
» availability object false none none
»» message string true none The availability message of the product
»» minOrderQuantity integer true none The minimum quantity of this product that can be purchased
»» maxOrderQuantity integer true none The maximum quantity of this product that can be purchased

Get redeemable points for a member

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/redemption/points', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/redemption/points HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/redemption/points \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/redemption/points',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/redemption/points

This endpoint returns a list of redeemable points/currency for a specific member

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning

Example responses

403 Response

{
  "code": 0,
  "message": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
403 Forbidden Access to the resource has been denied errorModel

Get comments for specific feed item.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/srw/feed/{feedID}/comments', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/srw/feed/{feedID}/comments HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/srw/feed/{feedID}/comments \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/srw/feed/{feedID}/comments',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /srw/feed/{feedID}/comments

This endpoint returns a list of comments that are against a specific feed item in the social recognition feed

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
feedID path string true Feed Identifier

Example responses

400 Response

{
  "code": 0,
  "message": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
400 Bad Request Bad request. errorModel
403 Forbidden Access to the resource has been denied errorModel
404 Not Found Feed was not found. errorModel

Get social recognition feed

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/srw/feed', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/srw/feed?count=0 HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/srw/feed?count=0 \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/srw/feed?count=0',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /srw/feed

This endpoint will return the social recognition feed for the current member. These are all recognition moments that are shared.

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
maxId query integer false Identifier of the last max feed record.
count query integer true Count of items per page.

Example responses

400 Response

{
  "code": 0,
  "message": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful operation None
400 Bad Request Bad request. errorModel
403 Forbidden Access to the resource has been denied errorModel
404 Not Found Feed was not found. errorModel

Customer Recognition

Ability to send nomination to someone from outside.

Create a new customer recognition

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'multipart/form-data',
    'Accept' => 'application/json',
    'Authorization' => 'string',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/recognition/customer', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/recognition/customer HTTP/1.1
Host: api.rewardgateway.net
Content-Type: multipart/form-data
Accept: application/json
Authorization: string
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X POST https://api.rewardgateway.net/recognition/customer \
  -H 'Content-Type: multipart/form-data' \
  -H 'Accept: application/json' \
  -H 'Authorization: string' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'


const inputBody = '{
  "rrProgramId": 0,
  "sender": "string",
  "nominee": "string",
  "awardId": 0,
  "nominationReason": "string"
}';
const headers = {
  'Content-Type':'multipart/form-data',
  'Accept':'application/json',
  'Authorization':'string',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/customer',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /recognition/customer

Creates a new customer recognition.

Body parameter

rrProgramId: 0
sender: string
nominee: string
awardId: 0
nominationReason: string

Parameters

Name In Type Required Description
Authorization header string true Authorization Header with Bearer Token
Accept header string true Accept Header with Vendor Versioning
body body object true none

Example responses

201 Response

null

Responses

Status Meaning Description Schema
201 Created Created customerRecognition

Get details for making request for external recognition form.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/details/view/{hash}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/details/view/{hash} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/details/view/{hash} \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0'
};

fetch('https://api.rewardgateway.net/recognition/details/view/{hash}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/details/view/{hash}

Fetching details needed for customer recognition external form scheme.

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
hash path string true Hash from external page url.

Example responses

200 Response

{
  "request_headers": {
    "Accept": "application/vnd.rewardgateway+json; version=3.0",
    "Authorization": "[access token]"
  },
  "request_urls": {
    "fetch_form_scheme_url": "string",
    "store_form_url": "string"
  },
  "scheme_id": "string",
  "rr_scheme_id": "string",
  "page_data": {
    "submit_page": {
      "title": "Thank you title.",
      "description": "Thank you description."
    },
    "submit_page_button": {
      "hasButton": true,
      "text": "Button text",
      "link": "Link to"
    }
  }
}

Responses

Status Meaning Description Schema
200 OK All details needed for making request to Customer Recognition endpoints. customerRequestDetails
404 Not Found Resource was not found. errorModel

Get customer recognition form structure.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/recognition/scheme/{schemeId}/{rrSchemeId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/recognition/scheme/{schemeId}/{rrSchemeId} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/recognition/scheme/{schemeId}/{rrSchemeId} \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/recognition/scheme/{schemeId}/{rrSchemeId}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /recognition/scheme/{schemeId}/{rrSchemeId}

Customer Recognition form structure returned as json.

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
schemeId path string true Clients scheme id
rrSchemeId path string true Reward and Recognition programme id

Example responses

200 Response

{
  "fields": [
    {
      "id": "RRNomineeAsText",
      "type": "checkbox",
      "label": "Who would you like to recognize?",
      "description": "Example description",
      "isHidden": true,
      "isRequired": true,
      "options": [
        {
          "value": "18",
          "label": "-- Select --"
        }
      ]
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK External recognition form structure needed to build fronend form. customerFormStructure
400 Bad Request Bad Request. errorModel

Create external recognition.

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://api.rewardgateway.net/recognition/store/{schemeId}/{rrSchemeId}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


POST https://api.rewardgateway.net/recognition/store/{schemeId}/{rrSchemeId} HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X POST https://api.rewardgateway.net/recognition/store/{schemeId}/{rrSchemeId} \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/recognition/store/{schemeId}/{rrSchemeId}',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

POST /recognition/store/{schemeId}/{rrSchemeId}

Submit new external recognition nomination.

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
schemeId path string true Clients scheme id
rrSchemeId path string true Reward and Recognition programme id

Example responses

200 Response

{
  "success": true,
  "message": "string",
  "errors": null,
  "nominationId": 0,
  "nominationFeedItem": {}
}

Responses

Status Meaning Description Schema
200 OK New customer nomination customerNominationEntity
400 Bad Request Bad Request. errorModel
422 Unprocessable Entity Validation errors if form is not valid. customerStoreValidationError

Retailers

Retailers Service

List retailers

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/retailers', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/retailers HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/retailers \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/retailers',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /retailers

Returns list of retailers

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token
page query integer false Page number for paginated collections
limit query integer false Number of items per page for paginated collections

Example responses

200 Response

{
  "page": 1,
  "limit": 20,
  "pages": 10,
  "total": 200,
  "title": "All Retailers",
  "_links": {
    "self": {
      "href": "/retailers?page=5&limit=20"
    },
    "first": {
      "href": "/retailers?page=1&limit=20"
    },
    "last": {
      "href": "/retailers?page=10&limit=20"
    },
    "next": {
      "href": "/retailers?page=6&limit=20"
    },
    "previous": {
      "href": "/retailers?page=4&limit=20"
    }
  },
  "_embedded": {
    "retailers": [
      {
        "retailer": {
          "id": 1234,
          "name": "Acme",
          "logo": "https://www.acme.com/path/to/image.jpg",
          "description": "Retailer description for Acme",
          "isFavourite": true,
          "isFeatured": true,
          "category": {
            "id": 123,
            "name": "Reloadable cards",
            "_links": {
              "self": {
                "href": "/category/{categoryId}"
              },
              "hierarchy": {
                "href": "/category/{categoryId}/hierarchy"
              }
            }
          },
          "_links": {
            "self": {
              "href": "/retailer/{retailerId}"
            },
            "offers": {
              "href": "/retailer/{retailerId}/offers"
            }
          }
        },
        "bestOffer": {
          "id": 9999,
          "type": "Cashback",
          "description": "Description for this offer",
          "keyInformation": "Key information for this offer",
          "howItWorks": "Details on how this offer works",
          "termsAndConditions": "Terms & conditions of this offer",
          "expiryDate": "2019-08-24T14:15:22Z",
          "specialOffer": true,
          "redeemableOnDesktop": true,
          "redeemableOnMobile": true,
          "discount": {
            "saving": "Earn 3%",
            "description": "on all offers",
            "useableInStore": true,
            "useableOnline": true,
            "startsOn": "2019-08-24T14:15:22Z",
            "endsOn": "2019-08-24T14:15:22Z"
          },
          "normally": {
            "saving": "Earn 3%",
            "description": "on all offers",
            "useableInStore": true,
            "useableOnline": true,
            "startsOn": "2019-08-24T14:15:22Z",
            "endsOn": "2019-08-24T14:15:22Z"
          },
          "_links": {
            "self": {
              "href": "/offer/{offerId}"
            }
          }
        }
      }
    ]
  }
}

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
401 Unauthorized Access token expired standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
» page integer(int32) true none none
» limit integer(int32) true none none
» pages integer(int32) true none none
» total integer(int32) true none none
» title string true none none
» _links object false none none
»» self object false none none
»»» href string false none Endpoint to access the current page of results
»» first object false none none
»»» href string false none Endpoint to access the first page of results
»» last object false none none
»»» href string false none Endpoint to access the last page of results
»» next object false none none
»»» href string false none Endpoint to access the next page of results
»» previous object false none none
»»» href string false none Endpoint to access the previous page of results
» _embedded object true none none
»» retailers [retailerDetails] false none none
»»» retailer object true none none
»»»» id integer(int32) true none Retailer identifier
»»»» name string true none Retailer's name
»»»» logo string true none Retailer's logo (URL)
»»»» description string true none Retailer's description
»»»» isFavourite boolean true none Is retailer favourited
»»»» isFeatured boolean true none Is retailer featured
»»»» category object false none none
»»»»» id integer(int32) true none Category identifier
»»»»» name string true none Category name
»»»»» _links object false none none
»»»»»» self object false none none
»»»»»»» href string false none Endpoint to access this resource
»»»»»» hierarchy object false none none
»»»»»»» href string false none Endpoint to retrieve category hierarchy
»»»» _links object false none none
»»»»» self object false none none
»»»»»» href string false none Endpoint to access this resource
»»»»» offers object false none none
»»»»»» href string false none Endpoint to retrieve all retailer's offers
»»» bestOffer object true none none
»»»» id integer(int32) true none Offer identifier
»»»» type string true none Type of the offer
»»»» description string true none Offer's description
»»»» keyInformation string true none Offer's key information
»»»» howItWorks string true none How the offer works
»»»» termsAndConditions string true none Offer's terms and conditions
»»»» expiryDate string(date-time) true none Offer's expiry date
»»»» specialOffer boolean true none Is this a special offer?
»»»» redeemableOnDesktop boolean true none Offer can be redeemed on the desktop
»»»» redeemableOnMobile boolean true none Offer can be redeemed on mobile
»»»» discount object true none none
»»»»» saving string true none Discount savings
»»»»» description string true none Discount description
»»»»» useableInStore boolean true none Discount can be used in-store
»»»»» useableOnline boolean true none Discount can be used online
»»»»» startsOn string(date-time) true none Discount is valid from
»»»»» endsOn string(date-time) true none Discount is valid until
»»»» normally object false none none
»»»» _links object false none none
»»»»» self object false none none
»»»»»» href string false none Endpoint to access this resource

New Retailers

Code samples

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Accept' => 'application/vnd.rewardgateway+json;version=3.0',
    'Authorization' => 'string',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://api.rewardgateway.net/retailers/new', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...


GET https://api.rewardgateway.net/retailers/new HTTP/1.1
Host: api.rewardgateway.net
Accept: application/json
Accept: application/vnd.rewardgateway+json;version=3.0
Authorization: string


# You can also use wget
curl -X GET https://api.rewardgateway.net/retailers/new \
  -H 'Accept: application/json' \
  -H 'Accept: application/vnd.rewardgateway+json;version=3.0' \
  -H 'Authorization: string'



const headers = {
  'Accept':'application/json',
  'Accept':'application/vnd.rewardgateway+json;version=3.0',
  'Authorization':'string'
};

fetch('https://api.rewardgateway.net/retailers/new',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

GET /retailers/new

Returns list of new retailers

Parameters

Name In Type Required Description
Accept header string true Accept Header with Vendor Versioning
Authorization header string true Authorization Header with Bearer Token

Example responses

200 Response

[
  {
    "retailer": {
      "id": 1234,
      "name": "Acme",
      "logo": "https://www.acme.com/path/to/image.jpg",
      "description": "Retailer description for Acme",
      "isFavourite": true,
      "isFeatured": true,
      "category": {
        "id": 123,
        "name": "Reloadable cards",
        "_links": {
          "self": {
            "href": "/category/{categoryId}"
          },
          "hierarchy": {
            "href": "/category/{categoryId}/hierarchy"
          }
        }
      },
      "_links": {
        "self": {
          "href": "/retailer/{retailerId}"
        },
        "offers": {
          "href": "/retailer/{retailerId}/offers"
        }
      }
    },
    "bestOffer": {
      "id": 9999,
      "type": "Cashback",
      "description": "Description for this offer",
      "keyInformation": "Key information for this offer",
      "howItWorks": "Details on how this offer works",
      "termsAndConditions": "Terms & conditions of this offer",
      "expiryDate": "2019-08-24T14:15:22Z",
      "specialOffer": true,
      "redeemableOnDesktop": true,
      "redeemableOnMobile": true,
      "discount": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "normally": {
        "saving": "Earn 3%",
        "description": "on all offers",
        "useableInStore": true,
        "useableOnline": true,
        "startsOn": "2019-08-24T14:15:22Z",
        "endsOn": "2019-08-24T14:15:22Z"
      },
      "_links": {
        "self": {
          "href": "/offer/{offerId}"
        }
      }
    }
  }
]

Responses

Status Meaning Description Schema
200 OK Successful operation Inline
401 Unauthorized Access token expired standardModel

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [retailerDetails] false none none
» retailer object true none none
»» id integer(int32) true none Retailer identifier
»» name string true none Retailer's name
»» logo string true none Retailer's logo (URL)
»» description string true none Retailer's description
»» isFavourite boolean true none Is retailer favourited
»» isFeatured boolean true none Is retailer featured
»» category object false none none
»»» id integer(int32) true none Category identifier
»»» name string true none Category name
»»» _links object false none none<