# Recurly External Subscription API

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

A subscription from an external resource that is not managed by the Recurly platform and instead is managed by third-party platforms like Apple App Store and Google Play Store.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/external_subscriptions` | Create an external subscription |
| GET | `/external_subscriptions` | List the external subscriptions on a site |
| GET | `/external_subscriptions/{external_subscription_id}` | Fetch an external subscription |
| PUT | `/external_subscriptions/{external_subscription_id}` | Update an external subscription |
| GET | `/external_subscriptions/{external_subscription_id}/external_invoices` | List the external invoices on an external subscription |
| GET | `/external_subscriptions/{external_subscription_id}/external_payment_phases` | List the external payment phases on an external subscription |

## Machine-readable artifacts (32)

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

External Subscription

---

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