Stripe

Stripe Invoices API

The Invoices API from Stripe — 12 operation(s) for invoices.

GitHub OpenAPI
Business capability
Invoicing & Statement Management BC-4250.30

Operations 15

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/invoices List invoices · Get invoices #
Ask an LLM
“How do I list all the invoices I've issued?”
“Can I see only the unpaid or open invoices for one customer?”
Tell an agent
List my most recent invoices.
List invoices for customer {customer} with status {status}.
POST /v1/invoices Create a draft invoice · Post invoices #
Ask an LLM
“How do I create an invoice for a customer?”
“Can I send an invoice for manual payment instead of charging the card automatically?”
Tell an agent
Create a draft invoice for customer {customer}.
Draft an invoice for customer {customer} due in {days_until_due} days, sent for manual payment.
GET /v1/invoices/search Search invoices with a query · Get invoices search #
Ask an LLM
“How do I search invoices by amount, status or metadata?”
“Is invoice search up to date immediately after I create an invoice?”
Tell an agent
Search invoices matching {query}.
Find invoices where {query}, returning at most {limit}.
GET /v1/invoices/upcoming Preview a customer's upcoming invoice · Get invoices upcoming #
Ask an LLM
“How do I preview what a customer will be billed on their next invoice?”
“Can I see the prorated cost of a plan change before I make it?”
Tell an agent
Preview the upcoming invoice for customer {customer}.
Show the next invoice for subscription {subscription} if it switched to items {subscription_items}.
GET /v1/invoices/upcoming/lines List line items on an upcoming invoice · Get invoices upcoming lines #
Ask an LLM
“How do I page through every line item on a customer's next invoice?”
“What if the upcoming invoice has more line items than the preview shows?”
Tell an agent
List the line items on customer {customer}'s upcoming invoice.
Show the next {limit} upcoming invoice lines for subscription {subscription}.
DELETE /v1/invoices/{invoice} Delete a draft invoice · Delete invoices invoice #
Ask an LLM
“How do I throw away a draft invoice I don't need?”
“Can I delete an invoice that's already been finalized?”
Tell an agent destructive · confirm first
Delete draft invoice {invoice}.
Discard the unfinalized invoice {invoice} permanently.
GET /v1/invoices/{invoice} Retrieve an invoice · Get invoices invoice #
Ask an LLM
“How do I look up a single invoice?”
“Where do I check whether a specific invoice has been paid?”
Tell an agent
Get invoice {invoice}.
Show me the status and totals of invoice {invoice}.
POST /v1/invoices/{invoice} Edit an invoice · Post invoices invoice #
Ask an LLM
“How do I change an invoice before it's finalized?”
“What can I still edit on an invoice after it's finalized?”
Tell an agent
Change the due date of invoice {invoice} to {due_date}.
Set the memo on invoice {invoice} to {description}.
POST /v1/invoices/{invoice}/finalize Finalize a draft invoice · Post invoices invoice finalize #
Ask an LLM
“How do I finalize a draft invoice manually?”
“Can I finalize an invoice without it being collected automatically?”
Tell an agent
Finalize invoice {invoice}.
Finalize draft {invoice} with automatic collection set to {auto_advance}.
GET /v1/invoices/{invoice}/lines List an invoice's line items · Get invoices invoice lines #
Ask an LLM
“How do I get every line item on an invoice?”
“What if an invoice has more line items than are returned with it?”
Tell an agent
List the line items on invoice {invoice}.
Show {limit} line items from invoice {invoice}.
POST /v1/invoices/{invoice}/lines/{line_item_id} Update a line item on an invoice · Post invoices invoice lines line item id #
Ask an LLM
“How do I change the quantity or price of one line on an invoice?”
“Can I set tax amounts directly on an invoice line item?”
Tell an agent
Set the quantity of line {line_item_id} on invoice {invoice} to {quantity}.
Change the description of line {line_item_id} on invoice {invoice} to {description}.
POST /v1/invoices/{invoice}/mark_uncollectible Write off an invoice as uncollectible · Post invoices invoice mark uncollectible #
Ask an LLM
“How do I write off an invoice a customer is never going to pay?”
“Can I track bad debt by marking invoices uncollectible?”
Tell an agent
Mark invoice {invoice} as uncollectible.
Write off invoice {invoice} as bad debt.
POST /v1/invoices/{invoice}/pay Collect payment on an invoice · Post invoices invoice pay #
Ask an LLM
“How do I charge an invoice right now instead of waiting for automatic collection?”
“Can I mark an invoice as paid if the customer paid outside the platform?”
Tell an agent
Pay invoice {invoice} now.
Pay invoice {invoice} using payment method {payment_method}.
POST /v1/invoices/{invoice}/send Email an invoice to the customer · Post invoices invoice send #
Ask an LLM
“How do I manually send an invoice to a customer?”
“Can I resend an invoice email outside the normal subscription schedule?”
Tell an agent
Send invoice {invoice} to the customer.
Email invoice {invoice} for manual payment now.
POST /v1/invoices/{invoice}/void Void a finalized invoice · Post invoices invoice void #
Ask an LLM
“How do I cancel an invoice that's already finalized?”
“What's the difference between voiding and deleting an invoice?”
Tell an agent destructive · confirm first
Void invoice {invoice}.
Cancel finalized invoice {invoice} by voiding it.

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://artifacts.apis.io/stripe/openapi/stripe-invoices-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/stripe/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:stripe-invoices-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-invoices-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Stripe Invoice Invoices 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 (178 KB total) ---
# Full source: https://artifacts.apis.io/stripe/openapi/stripe-invoices-api-openapi.yml