The Voucherify Developer Hub

Welcome to the Voucherify developer hub. You'll find comprehensive guides and documentation to help you start working with Voucherify as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

API version upgrades

Keep track of changes and upgrades to the Voucherify API.

Your API version controls the API and webhook behavior you see (e.g., what properties you see in responses, what parameters you’re permitted to send in requests, etc.). Your version is set the first time you make an API request. When we change the API in a backwards-incompatible way, we release a new dated version, but to avoid breaking your code, we don’t change your version until you’re ready to upgrade.


How can I upgrade my API?

If you’re running an older version, you’ll want to upgrade to take advantage of the latest API. For changing your API version you must send a request to the Voucherify support team or go to contact page.

Moreover, to see what version you’re running and upgrade to the latest, you can go to the Account Settings view which is visible in Voucherify Dashboard.

Changes which Voucherify considers to be backwards-compatible

  • Adding new API resources.
  • Adding new optional request parameters to existing API methods.
  • Adding new properties to existing API responses.
  • Changing the order of properties in existing API responses.
  • Changing the length or format of object IDs or other opaque strings.
  • Adding new event types. It means that your webhook listener should gracefully handle unfamiliar events types.

API changelog




  • Responses from the voucher and campaign listing methods were moved to the new object structure. Methods will now render specific properties for a total count and an array of objects.
  • Introduced validation for listing parameters: limit and page. A limit can range between 1 and 100 items.
  • Get voucher/campaign methods render validation rules related to the voucher object. They can be inherited from a campaign.
  • Created an API method for getting a campaign identified by name.


Response from the voucher publish method was moved to the new object structure. Returned voucher details are wrapped by transaction object describing publication event:

  "id": "pub_whQzIndYoyZoqiLEKN0s04GK",
  "object": "publication",
  "created_at": "2017-04-20T13:18:01Z",
  "customer_id": "cust_mOjhGypfbqch0v3DpAA9LDXj",
  "tracking_id": "janusz",
  "channel": "API",
  "metadata": {
  "voucher": {}


This version introduces a new model for building Validation Rules. The extended mechanism gives an advanced configuration for making promo conditions.

The modifications in this version affect the following API methods:

  • List Promotion Tiers: replaced an object describing conditions by a list of records describing an association between rule and tier - validation_rule_assignments
  • List Promotion Tiers for campaign - as above
  • Promotion Tier Object - as above
  • Validation Rule Object - structure reorganized to handle advanced rules
  • Validation Rule Assignment Object - added object describing a relation between rules and linked promotions
  • Validation Rules - modified​ data model

The mechanics and details of Validation​ Rules builder are described in the Help Center.

Updated 4 months ago

API version upgrades

Keep track of changes and upgrades to the Voucherify API.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.