Stripe

Stripe Subscriptions API

The Subscriptions API from Stripe — 8 operation(s) for subscriptions.

GitHub OpenAPI
Business capability
Subscription Lifecycle Management BC-4240

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/subscriptions List subscriptions · Get subscriptions #
Ask an LLM
“How do I see all active subscriptions for a customer?”
“Can I list canceled or past-due subscriptions?”
Tell an agent
List subscriptions for customer {customer}.
Show subscriptions with status {status}.
POST /v1/subscriptions Start a subscription for a customer · Post subscriptions #
Ask an LLM
“How do I sign a customer up for a recurring plan?”
“Can I start a subscription with a free trial?”
Tell an agent
Subscribe customer {customer} to {items}.
Start {customer} on {items} with a {trial_period_days}-day trial.
GET /v1/subscriptions/search Search subscriptions · Get subscriptions search #
Ask an LLM
“How do I find subscriptions matching a status or metadata value?”
“Is subscription search up to date right after I make a change?”
Tell an agent
Search subscriptions for {query}.
Find up to {limit} subscriptions matching {query}.
DELETE /v1/subscriptions/{subscription_exposed_id} Cancel a subscription now · Delete subscriptions subscription exposed id #
Ask an LLM
“How do I cancel a customer's subscription immediately?”
“Can I invoice outstanding usage when I cancel a subscription?”
Tell an agent destructive · confirm first
Cancel subscription {subscription_exposed_id} immediately.
Cancel subscription {subscription_exposed_id} and invoice now: {invoice_now}.
GET /v1/subscriptions/{subscription_exposed_id} Get a subscription · Get subscriptions subscription exposed id #
Ask an LLM
“How do I check a subscription's status and next renewal?”
“What items and prices are on this subscription?”
Tell an agent
Show subscription {subscription_exposed_id}.
Check when subscription {subscription_exposed_id} renews.
POST /v1/subscriptions/{subscription_exposed_id} Change a subscription · Post subscriptions subscription exposed id #
Ask an LLM
“How do I upgrade or downgrade a customer's subscription?”
“Can I cancel at the end of the billing period instead of right away?”
Tell an agent
Change subscription {subscription_exposed_id} to items {items}.
Cancel subscription {subscription_exposed_id} at period end: {cancel_at_period_end}.
DELETE /v1/subscriptions/{subscription_exposed_id}/discount Remove a subscription's discount · Delete subscriptions subscription exposed id discount #
Ask an LLM
“How do I take a discount off a subscription?”
“Can I end a coupon early on a customer's plan?”
Tell an agent destructive · confirm first
Remove the discount from subscription {subscription_exposed_id}.
Stop the coupon on subscription {subscription_exposed_id}.
POST /v1/subscriptions/{subscription}/resume Resume a paused subscription · Post subscriptions subscription resume #
Ask an LLM
“How do I restart a subscription that's paused?”
“Can I reset the billing cycle when resuming a subscription?”
Tell an agent
Resume subscription {subscription}.
Resume subscription {subscription} with billing cycle anchor {billing_cycle_anchor}.

Documentation

📖
Documentation
https://stripe.com/docs/apple-pay
📖
Documentation
https://stripe.com/docs/api/application_fees
📖
APIReference
https://docs.stripe.com/api/application_fees
📖
Documentation
https://stripe.com/docs/api/secret_management
📖
Documentation
https://stripe.com/docs/payments/payment-methods
📖
Documentation
https://stripe.com/docs/payments/setup-intents
📖
Documentation
https://stripe.com/docs/api/subscriptions
📖
APIReference
https://docs.stripe.com/api/subscriptions
📖
Documentation
https://stripe.com/docs/api/webhook_endpoints
📖
APIReference
https://docs.stripe.com/api/webhook_endpoints

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-subscriptions-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/asyncapi/stripe-webhooks-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/stripe-subscriptions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

stripe-subscriptions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Stripe Subscription Subscriptions API
  description: Needs description.
  contact:
    email: dev-platform@stripe.com
    name: Stripe Dev Platform Team
    url: https://stripe.com
  termsOfService: https://stripe.com/us/terms/
  version: '2023-10-16'
  x-stripeSpecFilename: spec3
servers:
- url: https://api.stripe.com/
security:
- basicAuth: []
- bearerAuth: []
tags:


# --- truncated at 32 KB (104 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-subscriptions-api-openapi.yml