# Ready2order Coupon API

**Canonical:** https://apis.io/apis/ready2order/ready2order-coupon-api/  
**Provider:** Ready2order — https://apis.io/providers/ready2order/  
**Base URL:** https://api.ready2order.com/v1  
**Documentation:** https://ready2order.com/api/doc

Ready2order Coupon API is one of 36 APIs that [Ready2order](https://apis.io/providers/ready2order/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Coupon. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

<!-- markdownlint-disable MD041 MD033 MD051 github-internal-links relative-links -- tag description snippet, not a standalone document; the tag name serves as the heading in the API docs --> Coupons are gift cards and vouchers that merchants sell and later accept as payment at the point of sale. The `coupon_value` field always holds the current remaining balance. **Balance and Lifecycle** You create a coupon with an initial value. From there you can [charge it](#operation/couponChargeById) (add value) or [redeem it](#operation/couponRedeemById) (deduct value). Partial redemptions work fine; the coupon stays active until the balance reaches zero. **Coupon Purpose** `coupon_purpose` determines when VAT is due. We distinguish between two voucher types: | Purpose | When VAT is due | `coupon_containsVat` | |---------|-----------------|----------------------| | `single` | At issuance (place of supply and tax rate are known at creation) | The applicable rate, e.g. `20` | | `multi` | At redemption (the POS applies the right rate per item) | Must be `0` | Single-purpose suits vouchers for specific goods at a fixed rate, such as a drink voucher tied to a particular product.<br> Multi-purpose fits general gift cards redeemable for anything or across multiple locations. Check with your tax advisor which type applies to your situation. **Identifier** `coupon_identifier` is the numeric code printed on physical voucher cards. If you leave it out, an EAN-13 code is generated automatically. Pass it as the `identifier` query parameter on [GET /coupons](#operation/couponGetAll) to look up a coupon by barcode scan.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ready2order/refs/heads/main/openapi/ready2order-coupon-api-openapi.yml
- **Documentation** — https://ready2order.com/api/doc
- **APIReference** — https://ready2order.com/api/doc

## Other Ready2order APIs (12)

- [Ready2order Account Token API](https://apis.io/apis/ready2order/ready2order-account-token-api/)
- [Ready2order Accounting Financial Year API](https://apis.io/apis/ready2order/ready2order-accounting-financial-year-api/)
- [Ready2order Bill API](https://apis.io/apis/ready2order/ready2order-bill-api/)
- [Ready2order Bill Type API](https://apis.io/apis/ready2order/ready2order-bill-type-api/)
- [Ready2order Country API](https://apis.io/apis/ready2order/ready2order-country-api/)
- [Ready2order Coupon Category API](https://apis.io/apis/ready2order/ready2order-coupon-category-api/)
- [Ready2order Currency API](https://apis.io/apis/ready2order/ready2order-currency-api/)
- [Ready2order Customer API](https://apis.io/apis/ready2order/ready2order-customer-api/)
- [Ready2order Customer Group API](https://apis.io/apis/ready2order/ready2order-customer-group-api/)
- [Ready2order Daily Report API](https://apis.io/apis/ready2order/ready2order-daily-report-api/)
- [Ready2order Device API](https://apis.io/apis/ready2order/ready2order-device-api/)
- [Ready2order Discount API](https://apis.io/apis/ready2order/ready2order-discount-api/)

## Tags

Coupon

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ready2order/ready2order-coupon-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ready2order/.