Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Recharge Subscriptions API

Recurring subscription lines that drive future charges and orders.

Recharge Subscriptions API is one of 10 APIs that Recharge publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Subscriptions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 8 operations across 5 paths, and defines 1 schema. It is described by OpenAPI 3.0.3, at version 2021-11.

Requests are made against a single base URL, https://api.rechargeapps.com.

8 operations 5 paths 1 schemas 1 DELETE2 GET4 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2021-11
Base URL
https://api.rechargeapps.com
Authentication
API Key
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Recharge Subscriptions API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Recharge-Access-Token (apiToken). By default, every request must be authenticated.

  • apiToken — Store API token generated in the Recharge merchant portal under Apps and integrations.

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 1 DELETE, 2 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Subscriptions 8

Recurring subscription lines that drive future charges and orders.

GET
/subscriptions
List subscriptions
listSubscriptions 2 params → 200401429
POST
/subscriptions
Create a subscription
createSubscription body → 201401429
GET
/subscriptions/{id}
Retrieve a subscription
getSubscription 1 param → 200404
PUT
/subscriptions/{id}
Update a subscription
updateSubscription 1 param body → 200
DELETE
/subscriptions/{id}
Delete a subscription
deleteSubscription 1 param → 204
POST
/subscriptions/{id}/change_next_charge_date
Change the next charge date
changeNextChargeDate 1 param → 200
POST
/subscriptions/{id}/cancel
Cancel a subscription
cancelSubscription 1 param → 200
POST
/subscriptions/{id}/activate
Activate a cancelled subscription
activateSubscription 1 param → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Subscription (12 properties). Each schema is shown below with its type and property counts.

Subscription
object
12 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

recharge-payments-subscriptions-api-openapi.yml Raw ↑

Other APIs Recharge publishes across the network.

Recharge Addresses API
Recharge Charges API
Recharge Customers API
Recharge Discounts API
Recharge Onetimes API
Recharge Orders API
Recharge Payment Methods API
Recharge Products API
Recharge Webhooks API