# Recurly Subscription Change API

**Canonical:** https://apis.io/apis/recurly/recurly-subscription-change-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 Subscription Change 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 Subscription Change. 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.

Subscription changes alter subscription in a way that might affect the invoiced amount, such as changing the plan, add-ons, quantities, or shipping address. Changes can be made immediately in the current billing cycle or scheduled to take place at the next renewal.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/subscriptions/{subscription_id}/change` | Fetch a subscription's pending change |
| POST | `/subscriptions/{subscription_id}/change` | Create a new subscription change |
| DELETE | `/subscriptions/{subscription_id}/change` | Delete the pending subscription change |
| POST | `/subscriptions/{subscription_id}/change/preview` | Preview a new subscription change |

## Machine-readable artifacts (32)

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

Subscription Change

---

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