Stripe Credit Notes API

Issue a credit note to adjust an invoice's amount after the invoice is finalized.

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/credit_notes List credit notes · Get credit notes #
Ask an LLM
“How do I see all the credit notes I've issued against invoices?”
“Can I list the credit notes for one customer or one invoice?”
Tell an agent
List my recent credit notes.
List credit notes for customer {customer}.
POST /v1/credit_notes Issue a credit note on an invoice · Post credit notes #
Ask an LLM
“How do I reduce what a customer owes on a finalized invoice?”
“Can a credit note refund money on an invoice that's already paid, or credit the customer's balance instead?”
Tell an agent
Issue a credit note for {amount} on invoice {invoice}.
Credit invoice {invoice} for reason {reason} with memo {memo}.
GET /v1/credit_notes/preview Preview a credit note before issuing it · Get credit notes preview #
Ask an LLM
“Can I see what a credit note would look like before I actually issue it?”
“How do I check the effect of a credit on an invoice total without committing it?”
Tell an agent
Preview a credit note for {amount} on invoice {invoice}.
Show me a draft credit note for invoice {invoice} with reason {reason}.
GET /v1/credit_notes/preview/lines List line items of a credit note preview · Get credit notes preview lines #
Ask an LLM
“How do I page through every line item in a previewed credit note?”
“Can I see the full list of credited lines before issuing the credit note?”
Tell an agent
List the preview credit note lines for invoice {invoice}.
Show all line items of a previewed credit for invoice {invoice} with lines {lines}.
GET /v1/credit_notes/{credit_note}/lines List line items on a credit note · Get credit notes credit note lines #
Ask an LLM
“How do I get every line item on a credit note I already issued?”
“Can I page through a long list of credit note lines?”
Tell an agent
List the line items on credit note {credit_note}.
Show the first {limit} lines of credit note {credit_note}.
GET /v1/credit_notes/{id} Look up a credit note · Get credit notes id #
Ask an LLM
“How do I view the details of one credit note?”
“What amount and reason are recorded on a specific credit note?”
Tell an agent
Get credit note {id}.
Show me the amount and status of credit note {id}.
POST /v1/credit_notes/{id} Update a credit note's memo · Post credit notes id #
Ask an LLM
“Can I change the memo on a credit note after it's issued?”
“How do I add my own metadata to an existing credit note?”
Tell an agent
Set the memo on credit note {id} to {memo}.
Add metadata {metadata} to credit note {id}.
POST /v1/credit_notes/{id}/void Void a credit note · Post credit notes id void #
Ask an LLM
“How do I cancel a credit note I issued by mistake?”
“What happens when I void a credit note?”
Tell an agent destructive · confirm first
Void credit note {id}.
Mark credit note {id} as void.

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-credit-notes-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.

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

OpenAPI Specification

stripe-credit-notes-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Stripe Credit Notes 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 (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-credit-notes-api-openapi.yml