Shoutout Enterprise Loyalty Admin (1.0.0)

Download OpenAPI specification:Download

ShoutOUT Labs: support@getshoutout.com URL: https://getshoutout.com

Shoutout loyalty for enterprises

Authentication

APIKey

Security Scheme Type	HTTP
HTTP Authorization Scheme	bearer

Users

User is a loyalty user which is the primary entity in the loyalty platform.

Get users list

Get the list of loyalty users.

Authorizations:

APIKey

query Parameters

skip	number Number of records to skip
limit	number Number of records to be returned in the response. Defult is 10

Responses

200

Success

get /users

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/users

Response samples

Content type

application/json

Copy

Expand all Collapse all


[
{"loyalty_id": "some text",
"name": "some text",
"points": 57.32,
"tier": "some text",
"tier_points": 77.17
},
{"loyalty_id": "some text",
"name": "some text",
"points": 56.08,
"tier": "some text",
"tier_points": 70.6
}
]

Create user

Create customer with pre-defined and user defined attributes

Request Body schema: application/json

loyalty_id	string Loyalty id of the customer
name	string Name of the customer
mobile_number	string
email	string
birth_date	string <date-time>
gender	string Enum: "male" "female"
location	string

Responses

201

Customer created

post /users

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/users

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"loyalty_id": "some text",
"name": "some text",
"mobile_number": "some text",
"email": "some text"
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"loyalty_id": "some text",
"name": "some text",
"points": 3.8,
"tier": "some text",
"tier_points": 30.44
}

Get user

Get a single customer profile via the loyalty id

Authorizations:

APIKey

path Parameters

loyaltyId

required

string

loyalty id

Responses

200

Success

404

Customer not found

get /users/{loyaltyId}

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/users/{loyaltyId}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"loyalty_id": "some text",
"name": "some text",
"points": 87.68,
"tier": "some text",
"tier_points": 34.99
}

Rewards

Digital, Voucher based rewards which can be redeemed for redeemable points.

Get rewards

Get list of all rewards

Authorizations:

APIKey

Responses

200

return rewards as an array

get /rewards

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/rewards

Response samples

Content type

application/json

Copy

Expand all Collapse all


[
{"_id": "5c7cb58fe5cd6a27acff234",
"name": "Reward1",
"description": "description",
"type": "voucher",
"isRedeemable": true,
"points": 2500,
"status": 0,
"imageUrls": 
["https://getshoutout.com/casx.jpg"
],
"metadata": 
{"totalCount": 0,
"usedCount": 0,
"amountPerRedemption": 0,
"countPerRedemption": 1,
"couponResult": 
{"fieldCount": 0,
"affectedRows": 1,
"insertId": 0,
"serverStatus": 2,
"warningCount": 0,
"message": "",
"protocol41": true,
"changedRows": 0
}
},
"ownerId": "43",
"createdBy": "43",
"createdOn": "2019-02-25T05:09:18.628Z"
}
]

Create reward

Create a new reward

Authorizations:

APIKey

Request Body schema: application/json

imageUrls required	Array of strings image urls array
name required	string reward name
points required	integer number of redeemable points required to redeem the reward
type required	string Reward type
metadata	object (Object) JSON type
userRedeemable required	boolean whether user allowed to redeem the reward
status required	integer reward published/ unpublished status

Responses

201

post /rewards

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/rewards

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"imageUrls": 
["https://s3.amazonaws.com/gallery.getshoutout.com/images/43/9656b64d-76e0-4e12-82fc-6fec4c6b0a68.png"
],
"name": "Reward 2",
"points": "100",
"type": "voucher",
"metadata": 
{"amountPerRedemptionSeasonal": [ ],
"amountPerRedemption": 0,
"dailyRedemptionLimit": -1
},
"userRedeemable": true
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"_id": "reward id",
"imageUrls": 
["imageurl1",
"imageurl2"
],
"name": "reward name",
"points": 0,
"type": "voucher",
"metadata": 
{"amountPerRedemptionSeasonal": [ ],
"amountPerRedemption": 0,
"dailyRedemptionLimit": -1
},
"userRedeemable": true,
"status": 0
}

Get reward

Get a reward by reward id

Authorizations:

APIKey

path Parameters

rewardId

required

string

reward id

Responses

200

get /rewards/{rewardId}

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/rewards/{rewardId}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"_id": "reward id",
"imageUrls": 
["imageurl1",
"imageurl2"
],
"name": "reward name",
"points": 0,
"type": "voucher",
"metadata": 
{"amountPerRedemptionSeasonal": [ ],
"amountPerRedemption": 0,
"dailyRedemptionLimit": -1
},
"userRedeemable": true,
"status": 0
}

Update reward

Update a reward by reward id

Authorizations:

APIKey

path Parameters

rewardId

required

string

reward id

Request Body schema: application/json

_id required	string Reward Id
imageUrls required	Array of strings list of images
name required	string Reward name
points required	integer no of redeemable points required to redeem the reward
type required	string Reward type
metadata	object (Object) JSON type
userRedeemable required	boolean Reward is redeemable or not
status required	integer <int32> Reward published(1)/Unpublished(0) status

Responses

200

put /rewards/{rewardId}

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/rewards/{rewardId}

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"_id": "reward id",
"imageUrls": 
["imageurl1",
"imageurl2"
],
"name": "reward name",
"points": 0,
"type": "voucher",
"metadata": 
{"amountPerRedemptionSeasonal": [ ],
"amountPerRedemption": 0,
"dailyRedemptionLimit": -1
},
"userRedeemable": true,
"status": 0
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"_id": "reward id",
"imageUrls": 
["imageurl1",
"imageurl2"
],
"name": "reward name",
"points": 0,
"type": "voucher",
"metadata": 
{"amountPerRedemptionSeasonal": [ ],
"amountPerRedemption": 0,
"dailyRedemptionLimit": -1
},
"userRedeemable": true,
"status": 0
}

Delete reward

Delete a reward by reward id

Authorizations:

APIKey

path Parameters

rewardId

required

string

reward id

Responses

200

empty response

delete /rewards/{rewardId}

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/rewards/{rewardId}

Products

Create, update, delete and get products. Products are the list of products in the Point of Sales (PoS) or e-commerce application.

Get products

Get list of products

Authorizations:

APIKey

query Parameters

skip	integer Number of records to skip
limit	integer Number of records to be returned in the response. Defult is 10

Responses

200

products list

get /products

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/products

Response samples

Content type

application/json

Copy

Expand all Collapse all


[
{"id": "product id",
"name": "product name",
"price": 0,
"metadata": 
{"sku": "some text"
}
}
]

Create product

Create a new product

Authorizations:

APIKey

Request Body schema: application/json

id required	string product id
name required	string product name
price required	integer product price
metadata	object (Object) JSON type

Responses

201

Product create/update response

post /products

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/products

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"id": "product id",
"name": "product name",
"price": 0,
"metadata": 
{"sku": "some text"
}
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"id": "product id",
"name": "product name",
"price": 0,
"metadata": 
{"sku": "some text"
}
}

Get product

Get the product by product id

Authorizations:

APIKey

path Parameters

productId

required

string

product id

Responses

200

Product create/update response

get /products/{productId}

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/products/{productId}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"id": "product id",
"name": "product name",
"price": 0,
"metadata": 
{"sku": "some text"
}
}

Update product

Update the product by product id

Authorizations:

APIKey

path Parameters

productId

required

string

product id

Request Body schema: application/json

id required	string product id
name required	string product name
price required	integer product price
metadata	object (Object) JSON type

Responses

200

Product create/update response

put /products/{productId}

ShoutOUT Loyalty Service

https://api.getshoutout.com/loyaltyservice2/products/{productId}

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all


{"id": "product id",
"name": "product name",
"price": 0,
"metadata": 
{"sku": "some text"
}