Stripe

Stripe Subscription Items API

The Subscription Items API from Stripe — 4 operation(s) for subscription items.

GitHub OpenAPI
Business capability
Subscription Modification BC-4240.40

Operations 7

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/subscription_items List items on a subscription · Get subscription items #
Ask an LLM
“How do I see every price and quantity on a subscription?”
“Which items make up this customer's subscription?”
Tell an agent
List items on subscription {subscription}.
Show the first {limit} items of subscription {subscription}.
POST /v1/subscription_items Add an item to a subscription · Post subscription items #
Ask an LLM
“How do I add an add-on to an existing subscription?”
“Does adding an item change the items already on the subscription?”
Tell an agent
Add price {price} to subscription {subscription}.
Add {quantity} of price {price} to subscription {subscription}.
DELETE /v1/subscription_items/{item} Remove an item from a subscription · Delete subscription items item #
Ask an LLM
“How do I remove an add-on without canceling the whole subscription?”
“Can I clear recorded usage when removing a subscription item?”
Tell an agent destructive · confirm first
Remove subscription item {item}.
Remove subscription item {item} and clear its usage: {clear_usage}.
GET /v1/subscription_items/{item} Get a subscription item · Get subscription items item #
Ask an LLM
“How do I look up one line item on a subscription?”
“What price and quantity does this subscription item have?”
Tell an agent
Show subscription item {item}.
Get the price and quantity of subscription item {item}.
POST /v1/subscription_items/{item} Change a subscription item · Post subscription items item #
Ask an LLM
“How do I change the quantity of seats on a subscription?”
“Can I swap an item to a different price mid-cycle?”
Tell an agent
Set the quantity of subscription item {item} to {quantity}.
Switch subscription item {item} to price {price}.
GET /v1/subscription_items/{subscription_item}/usage_record_summaries Get usage totals for a subscription item · Get subscription items subscription item usage record summaries #
Ask an LLM
“How much metered usage has a subscription item recorded this period?”
“Can I see usage summarized per billing period?”
Tell an agent
Show usage summaries for subscription item {subscription_item}.
List the last {limit} usage periods for subscription item {subscription_item}.
POST /v1/subscription_items/{subscription_item}/usage_records Report metered usage · Post subscription items subscription item usage records #
Ask an LLM
“How do I report usage for a metered subscription?”
“Can I overwrite a usage quantity instead of adding to it?”
Tell an agent
Record {quantity} units of usage on subscription item {subscription_item}.
Report {quantity} usage on {subscription_item} at {timestamp} with action {action}.

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-subscription-items-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-subscription-items-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-subscription-items-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Stripe Subscription Subscription Items 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 (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-subscription-items-api-openapi.yml