Xoxoday
  • 📓User Resources
    • 👨‍💼For Admins
      • 📌Getting Started
        • ⚙️Settings
          • Manage Super Admin/Admins
            • Hierarchy vs Non-Hierarchy
            • Threshold
            • Delete an Admin
            • Redemption APIs
              • Generic Redemption APIs
              • Oauth 2.0 Implementation for Stores Redemption
          • Platform Preferences
          • Account Verification
        • Types of Companies
      • 🚀Plum Launch Communication Kit
        • 🌉Pre-Launch Templates
        • 🤝Introduction to Plum Templates
        • 📺How to Sign up on Plum’s reward storefront Template
        • 📑How to Bookmark Plum’s reward storefront for easy access Template
        • 🎉How to Redeem the Rewards on Plum’s Reward Storefront?
      • Xoxo Points
        • 📌Getting Started
        • 🚚Distribution of Xoxo-points
        • 📩Email/SMS Customization
        • FAQs
      • Xoxo Codes
        • 📌Getting Started
        • 🚚Distribution of Xoxo-codes
        • 📩Email, SMS, and Xoxo Code Campaign Customization
        • FAQs
      • Points vs Codes
      • Xoxo Links
        • 📌Getting Started
        • 🚚Distribution of Xoxo-links
        • FAQs
      • Domain Authentication Guide
        • Troubleshooting Domain Authentication
      • 💰Add Funds
        • Base Currency
      • Campaigns
        • Getting Started
        • Editing a campaign?
        • Delete/disabling a Xoxo Campaign?
      • 🏬Reports
      • 💳Prepaid Card User Guide
        • Virtual Paypal International
          • 📌Getting Started
          • 📭How to Redeem?
        • Virtual Visa Card
          • 📌Getting Started
          • 💳How to Redeem?
      • 🔐Security and Compliance
        • Cryptography & Encryption
        • Email Whitelisting
        • Governance, Risk, & Data Compliance
        • Application,Dev & Security
        • Cloud Security
        • HR Compliance
        • Identity & Access Management
        • Solution Development
        • Security Operations
        • Training and Awareness
        • Vulnerability and Threat Management
        • Security Operations & Technical Capabilities and Support
        • Data Management
        • Policies & Procedures
        • Tax Compliance
        • Privacy Compliance
        • Cloud Security Alliance
        • Others
        • Documents
          • Data Security
          • Information Security
          • Admin/Business
          • Others
          • Finance Compliance
    • 🧑‍🤝‍🧑For End-Users
      • 📌Getting Started
      • 🧑‍💻Signing up/Logging in
      • 🪙How to redeem?
      • 💳Gift Vouchers
      • 🎁Gift Box Queries
      • 🚚Delivery Related Issues
      • 🛑Cancelation/Refunds
    • 🔗Pre-Built Integrations
      • Qualtrics Integration Guide
        • Using Qualtrics Workflow Extension to Send Rewards
        • Public Survey Rewarding
        • Anonymous Survey Rewarding
      • HubSpot + Plum
        • 1-1 Reward Widget in HubSpot
        • Workflow Based Reward Automation
        • 1-Many Link for Xoxolink’s Reward Automation
        • Email based Reward Automation
      • Darwinbox + Plum
      • SurveyMonkey + Plum
        • Public Survey Automation
        • Anonymous Survey Automation
      • Zapier + Plum
      • ActiveCampaign + Plum
        • Creating Automation
      • Salesforce + Plum
        • Getting Started with Xoxoday Plum
        • Getting Started and Setting up Salesforce Integration
        • Sending 1-1 Reward
        • Steps to create a Flow and add a Trigger
        • Redemption Journey for your Recipients
      • Typeform + Plum by Xoxoday
      • Zoho People + Plum
      • SAP Successfactors + Plum
        • SAP Client Registration with Xoxoday for Stores Redemption
      • Decipher - Forsta Integration
      • Zoho CRM
        • Send 1-1 rewards
        • Automation : Workflow Rules
      • Connect Plum to thousands of apps using Zapier
      • Other Integrations
    • 🛣️Product Roadmap
      • 2022
      • 2021
  • 👨‍💻Developer Resources
    • Rewards API
      • Getting started
      • API Endpoints
        • Authentication
          • Client ID, Secret ID, and Token Creation
          • Token Management
        • Catalog
          • GetVouchers API
          • GetFilters API
        • Orders
          • PlaceOrder API
          • GetOrderDetails API
          • GetOrderHistory API
        • Account Balance
          • GetBalance API
        • Postman Collection URL
      • Concepts
        • Staging Environment
        • Catalog
        • Error Handling
          • Standard HTTP status code summary
          • Errors related to API
        • Exchange Rates
      • Guides
        • Funding the Account
        • Reporting and Analytics
      • Webhooks
        • Test Webhooks
        • How to implement webhooks?
        • How to secure your webhooks?
      • Forex
      • Best Practices
      • Frequently Asked Questions
    • StoreFront Integration
      • Getting started
      • API Endpoints
        • Authorization
        • Token Creation & Token Management
        • SSO Redirection
        • End Points
      • Concepts
        • Points
      • Guides
        • Funding Account
        • Reports and Analytics
    • Xoxo Link API
    • Roadmap for 2021
  • 📅Release Notes
    • Release April 2023
    • Release March 2023
    • Release February 2023
    • Release December 2022
    • Release October 2022
    • Release September 2022
    • Release July 2022
    • Release May 2022
    • Release March 2022
    • Release February 2022
    • Release December 2021
    • Release November 2021
    • Release October 2021
    • Release September 2021
    • Release July 2021
    • Release May 2021
    • Release March 2021
    • Release December 2020
    • Release October 2020
    • Release September 2020
    • Release August 2020
    • Release June 2020
    • Release May 2020
    • Release April 2020
    • Release March 2020
Powered by GitBook
On this page

Was this helpful?

  1. Developer Resources
  2. Rewards API
  3. API Endpoints
  4. Catalog

GetVouchers API

GetVouchers API enables the user to get a list of vouchers with desired filters available with the Xoxoday catalog

PreviousCatalogNextGetFilters API

Last updated 1 year ago

Was this helpful?

Base URL :

Staging :

Production :

The GetVouchers API can only be called up to 500 times in a 24-hour period.

Currently, we do not support adding multiple filters in a single GetVouchersAPI call

curl -X POST {OAUTH_URL}/v1/oauth/api 
-H 'Authorization: Bearer eyJ0b2tlbkNvbnRlbnQiOnsiaXNzdWVkRm9yIjoiRnJlc2h3b3JrcyIsInNjb3BlIjoiIiwiaXNzdWVkQXQiOjE1NTk4MDQ1Nzg1ODIsImV4cGlyZXNBdCI6IjIwMTktMDYtMjFUMDc6MDI6NTguNTgyWiIsInRva2VuX3R5cGUiOiJVU0VSIn0sImFfdCI6ImV5SmxibU1pT2lKQk1USTRRMEpETFVoVE1qVTJJaXdpWVd4bklqb2lSVU5FU0MxRlV5SXNJbXRwWkNJNkltVnVZeUlzSW1Wd2F5STZleUpyZEhraU9pSkZReUlzSW1OeWRpSTZJbEF0TWpVMklpd2llQ0k2SWpoMmJVTkVRMUZQZW1wQlNHWndabXQ0TVhjNVluZHphM1JhZWtRek0ySXRZamx0VVhSclEyRnhNV3NpTENKNUlqb2lZMGR0V2kxdWIySjBWbUptTVdGdVNraDBUMmxoWW5VMFZHUlVhRzVVYmpCYWRuWnJabGMwYzBWb2N5SjlmUS4uU1h3TlNUSWhFUXNlN0htaXpPUmFIQS5NRzBVUy1lek1IOEFsbWFLc2ZTY3Nwa2FlYzBIcW9FcUV1YXRoNHRSTTRpeVg2dFByX1ZjTnlsdnk5YjlGLTZHR01DbjY1TjYwYnpIUUJtRVZvZGRYVWlvQS1kTkpuaE9KdThHczRfeW9pM042VGFOdWhjRENCUGtwWk1CeTlDRjJBaEh4UGotQkd0SzdEamhNbjBBQXpTM1VhTE11eUdrTmNwSGxQSUxNcFlVM' 
--header 'Content-Type: application/json'
  -d '{
	"query": "plumProAPI.mutation.getVouchers",
	"tag": "plumProAPI",
	"variables": {
		"data":{
		    "limit": 10,
        	    "page": 2,
        	    "includeProducts": "",
        	    "excludeProducts": "",
              "exchangeRate": 1,
        	    "sort": {
        		    "field":"",
        		    "order":""
        	    },
        	    "filters":[
        		{
        			"key": "productName",
        			"value": ""
        		},
        		{
        			"key": "country",
        			"value": ""
        		},
        		{
        			"key": "price",
        			"value": ""
        		},
        		{
        			"key": "minPrice",
        			"value": ""
        		},
        		{
        			"key": "maxPrice",
        			"value": ""
        		},
            {
              "key": "deliveryType",
              "value": ""
            },
        		{
        			"key": "currencyCode",
        			"value": ""
        		}
    		]
               }
	}
}

200 : Success

returns list of vouchers filtered by the applicable filters

{
    "data": {
        "getVouchers": {
           "status": 1,
           "data": [{
              "productId": 15365,
              "name": "Amazon.in",
              "description": "",
              "orderQuantityLimit": 10,
              "termsAndConditionsInstructions": "",
              "expiryAndValidity": "",
              "redemptionInstructions": "",
              "categories": "eCommerce",
              "lastUpdateDate": "2020-01-06 10:23:24",
              "imageUrl": "",
              "currencyCode": "INR",
              "currencyName": "rupees",
              "countryName": "India",
              "countryCode": "IN",
              "countries": [
               {
                "code": "IN",
                "name": "India", 
               }
              ],
              "valueType": "fixed_denomination",
              "maxValue": 0,
              "minValue": 0,
              "valueDenominations": "20,30,500,1000,2500",
              "tatInDays": "0",
              "usageType": "",
              "deliveryType": "",
              "isCommon": "",
              "fee": 0,
              "discount": 0
              "usageType": "",
              "exchangeRate": "1"
         }]
       }
    }
}

401 : Failure

Authorization error due to invalid or missing API key

{ 
   code: 401, 
	   errorId: "PIPE10013",
	   errorInfo: "Plum Pro APIs: Invalid authorization header",
   error: "Eg: Unauthorized, Client is unauthorized for international orders"
}

400 : Failure

Unable to get any vouchers

{
	   code: 400,
	   errorId: "PLE10033",
	   errorInfo: "Failed to validate getVouchers request",
   error:"Eg: Bad request"
}

404 : Failure

Failed to get product details

{ 
	   code: 404,
	   errorId: "PLE10017",
	   errorInfo: "Failed to get product details",
   error: "ProductId Not Found"
}

500 : Failure

Internal server error

{
	  "500": {
	   code: 500,
   error: "Eg: "Internal server error""
}

Parameters

Body Parameters

Property

Type

Description

limit*

Integer

Number of products desired per page

page*

Integer

Offset with respect to the limit provided(starts from 1),

includeProducts

String

Comma-separated product ids of products to be included

excludeProducts

String

Comma-separated product ids of products to be excluded

field

String

Fields to sort by, Eg: name, last update date

order

String

fields to order by. Eg: ASC, DESC

filters

Array

An array of optional filter property objects having key and value as keys mentioned below:

filter.productName

String

Product names to be included

filter.country

String

Countries to be included

filter.price

String

Price range filters to be included

filter.minPrice

String

The minimum price of the products looked for

filter.maxPrice

String

Maximum price of the products looked for

filter.currencyCode

String

Currency codes to be included

filter.deliveryType

String

Delivery type to the voucher (realtime or delayed)

"*" means the paramter is mandatory

filter.xyz=optional filter property objects

Body Parameters

Property

Type

Description

status

Integer

0 (Failure) / 1 (Successful)

productId

Integer

product Id of the product

name

String

name of the product

description

String

description of the product

orderQuantityLimit

Integer

Maximum order quantity allowed for the prpdouct

termsAndConditions

String

terms and conditions for the particular product

expiryAndValidity

String

expiry and validity of the product

redemptionInstructions

String

instructions to redeem the product

categories

String

categories to which this product belongs to

lastUpdateDate

String

last time and date when this product was updated

imageUrl

String

url of the image of the voucher if available

currencyCode

String

Currency code of the product

currencyName

String

The currency name of the product

countryName

String

The country in which this product can be redeemed

countryCode

String

Country code for the country in which this product can be redeemed

countries

Array

List of countries with country code and country name where the products can be redeemed

valueType

String

Declared values or variable values eg open_value or fixed_denomination

maxValue

Integer

Max value if given in request body

minValue

Integer

Min value if given in request body

valueDenominations

String

Comma separated denomination

tatInDays

String

Turn around time in days taken to process the order

usageType

String

Usage Type for eg: digital, offline,etc.

deliveryType

String

Realtime or Delayed

fee

Float

Any extra fees levied on this product

discount

FLoat

discount amount

exchangeRate

Integer

Exchange rate in comparison to client Base currency.

👨‍💻
https://stagingaccount.xoxoday.com/chef
https://accounts.xoxoday.com/chef