Getting Started with Coupon Promotion API v2.1


At Vouchery, we provide a powerful Coupon API that follows a REST architecture. Our API can be incorporated into web and mobile applications, enabling businesses and developers to improve and safeguard their coupon and discount promotions. The API serves as a link between our infrastructure for promotional incentives and different platforms across various channels, making the coupon and loyalty management process seamless, efficient, and secure.

In this documentation, you will find a detailed description of our API design, authentication and authorization, available endpoints, and responses to successful requests and errors.

If you have been using the previous version of our API - Vouchery API 2.0, make sure you get familiar with the changes described HERE.

If you have any further questions, please reach out at [email protected] or Join our Slack Community Channel to get advice from our Tech Team and other Vouchery Users.



To try out our API docs you will need proper credentials - your trial account or our sandbox.

Please check out Authorization section for more details or reach our to get API key.

Here are the key functionalities and benefits of our coupon promotion API v2.1:

  • Generate Coupons: Our API enables businesses to easily generate customized coupon codes with unique parameters, including promotion type, discount percentages, expiration dates, and usage restrictions.
  • Redeem Coupons: Businesses can leverage our API to facilitate coupon redemption within their applications. It verifies the coupon's validity and applies the relevant discount or promotion, ensuring a smooth and user-friendly experience for customers.
  • Display applicable promotions to Customers: Our API makes it easy to query active or specific promotions, removing any ineligible ones for each customer. It allows pulling coupons assigned to a particular customer and accessing their past transactions, including loyalty points activity and rejected coupon attempts.
  • Manage Customer data: To improve promotions and the functionality of our app, you can include Customer Segment tags in your Customer records. This will increase the personalization and targeting of each promotion and enable UI users to create promotional workflows.
  • Retrieve Coupon Information: Clients can use our API to retrieve detailed information about a particular coupon, including the reward information, discount amount, expiration date, and usage history.
  • Check Coupon Validity: Our API provides real-time validation of coupon codes, ensuring that they meet specific criteria and are still active before being applied to a purchase.
  • Reporting and Analytics: Our API offers robust reporting and analytics features, enabling businesses to monitor the performance of their coupon campaigns. This includes tracking redemption rates, analyzing customer behavior, and making data-driven decisions to optimize their marketing strategies.
  • User Management: Our API simplifies user management related to coupon interactions. It allows businesses to keep track of which users have used specific coupons, how many times, and when.
  • Seamless Integration: Designed with flexibility, our coupon API seamlessly integrates into a wide range of platforms, from e-commerce websites and mobile apps to point-of-sale systems.
  • Enhanced Security: We understand the importance of security in coupon management. Our API includes features to prevent coupon fraud, such as setting usage limits and linking coupons to specific user accounts.

Have feedback regarding our API? Don't hesitate to use the option to "Suggest changes" or leave your opinion through 👍 👎.