# Recurly Coupon API

**Canonical:** https://apis.io/apis/recurly/recurly-coupon-api/  
**Provider:** Recurly — https://apis.io/providers/recurly/  
**Base URL:** https://v3.recurly.com  
**Documentation:** https://recurly.com/developers/api/v2021-02-25/index.html

Recurly Coupon API is one of 71 APIs that [Recurly](https://apis.io/providers/recurly/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 17 JSON Schema definitions. Tagged areas include Coupon. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a getting-started guide, a changelog, and 17 JSON Schemas.

Coupons can either be single codes that easily allow mass distribution by many customers or bulk coupons that can generate many unique coupons that can allow for individual delivery and tracking.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/coupons` | List a site's coupons |
| POST | `/coupons` | Create a new coupon |
| GET | `/coupons/{coupon_id}` | Fetch a coupon |
| PUT | `/coupons/{coupon_id}` | Update an active coupon |
| DELETE | `/coupons/{coupon_id}` | Expire a coupon |
| PUT | `/coupons/{coupon_id}/restore` | Restore an inactive coupon |

## Machine-readable artifacts (32)

- **OpenAPI** — https://artifacts.apis.io/recurly/openapi/recurly-coupon-api-openapi.yml
- **Documentation** — https://docs.recurly.com/recurly-subscriptions/docs/integration-paths
- **APIReference** — https://recurly.com/developers/api/v2021-02-25/index.html
- **Authentication** — https://docs.recurly.com/recurly-subscriptions/docs/api-keys
- **GettingStarted** — https://docs.recurly.com/recurly-subscriptions/docs/quick-start-guide
- **Webhooks** — https://docs.recurly.com/recurly-subscriptions/docs/overview-webhooks
- **ChangeLog** — https://recurly.com/developers/api/changelog.html
- **SourceCode** — https://github.com/recurly/recurly-client-spec
- **AsyncAPI** — https://artifacts.apis.io/recurly/asyncapi.yml
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-line-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-invoice-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-add-on-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-purchase-create-schema.json
- **APIReference** — https://recurly.com/developers/api-v2/v2.29/index.html
- **Documentation** — https://docs.recurly.com/recurly-subscriptions/docs/upgrade-to-api-v3
- **Documentation** — https://docs.recurly.com/recurly-commerce/docs/getting-started
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-billing-attempt-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-create-request-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-line-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-offer-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscriber-dto-schema.json
- **Documentation** — https://docs.recurly.com/recurly-recover/docs/getting-started
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-transaction-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-recovery-invoice-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-dunning-campaign-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-invoice-collection-schema.json
- **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-dunning-campaign-list-schema.json
- **Documentation** — https://docs.recurly.com/recurly-revrec/docs/getting-started
- **Documentation** — https://docs.recurly.com/recurly-engage/docs/recurly-engage-sdk

## Other Recurly APIs (12)

- [Recurly Compass MCP server](https://apis.io/apis/recurly/recurly-compass-mcp-server/)
- [Recurly Account Acquisition Info API](https://apis.io/apis/recurly/recurly-account-acquisition-info-api/)
- [Recurly Account API](https://apis.io/apis/recurly/recurly-account-api/)
- [Recurly Account Note API](https://apis.io/apis/recurly/recurly-account-note-api/)
- [Recurly Accounts API](https://apis.io/apis/recurly/recurly-accounts-api/)
- [Recurly Add On API](https://apis.io/apis/recurly/recurly-add-on-api/)
- [Recurly Adjustments API](https://apis.io/apis/recurly/recurly-adjustments-api/)
- [Recurly Automated Exports API](https://apis.io/apis/recurly/recurly-automated-exports-api/)
- [Recurly BaseOrderLineItems API](https://apis.io/apis/recurly/recurly-baseorderlineitems-api-api/)
- [Recurly BaseOrders API](https://apis.io/apis/recurly/recurly-baseorders-api-api/)
- [Recurly Billing Info API](https://apis.io/apis/recurly/recurly-billing-info-api/)
- [Recurly Billing Infos API](https://apis.io/apis/recurly/recurly-billing-infos-api/)

## Tags

Coupon

---

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