# Recurly Coupon Redemption API

**Canonical:** https://apis.io/apis/recurly/recurly-coupon-redemption-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 Redemption 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 Redemption. 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.

Coupon redemptions are created when a coupon is applied to an account or subscription. This allows you to track your promotions.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/accounts/{account_id}/coupon_redemptions` | List the coupon redemptions for an account |
| GET | `/accounts/{account_id}/coupon_redemptions/active` | List the coupon redemptions that are active on an account |
| POST | `/accounts/{account_id}/coupon_redemptions/active` | Generate an active coupon redemption on an account or subscription |
| DELETE | `/accounts/{account_id}/coupon_redemptions/active` | Delete the active coupon redemption from an account |
| GET | `/accounts/{account_id}/coupon_redemptions/{coupon_redemption_id}` | Show the coupon redemption |
| DELETE | `/accounts/{account_id}/coupon_redemptions/{coupon_redemption_id}` | Delete the coupon redemption |
| GET | `/invoices/{invoice_id}/coupon_redemptions` | List the coupon redemptions applied to an invoice |
| GET | `/subscriptions/{subscription_id}/coupon_redemptions` | List the coupon redemptions for a subscription |
| GET | `/subscriptions/{subscription_id}/coupon_redemptions/{coupon_redemption_id}` | Show the coupon redemption for a subscription |
| DELETE | `/subscriptions/{subscription_id}/coupon_redemptions/{coupon_redemption_id}` | Delete the coupon redemption from a subscription |

## Machine-readable artifacts (32)

- **OpenAPI** — https://artifacts.apis.io/recurly/openapi/recurly-coupon-redemption-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 Redemption

---

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