How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Stripe Invoice API

Invoices are statements of amounts owed by a customer, and are either generated one-off, or generated periodically from a subscription.

Stripe Invoice API is one of 159 APIs that Stripe publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 15 operations across 10 paths, and defines 23 schemas. It is described by OpenAPI 3.2.0, at version 2023-10-16.

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

15 operations 10 paths 23 schemas 2 DELETE4 GET9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2023-10-16
Server
https://api.stripe.com/
Authentication
HTTP Basic, HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 2

Stripe Invoice API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). It accepts HTTP bearer tokens (auth-scheme) (bearerAuth). By default, every request must be authenticated.

  • basicAuth — Basic HTTP authentication. Allowed headers-- Authorization: Basic | Authorization: Basic
  • bearerAuth — Bearer HTTP authentication. Allowed headers-- Authorization: Bearer

Paths & Operations 15

Across 10 paths, the API surfaces 15 operations — 2 DELETE, 4 GET, 9 POST. Each is listed below with its method, path, parameters, and response codes.

Invoice 15
GET
/v1/Invoice Items
Stripe Get Invoice Items
getInvoice Items 8 params body → 200default
POST
/v1/Invoice Items
Stripe Post Invoice Items
postInvoice Items body → 200default
DELETE
/v1/Invoice Items/{invoiceitem}
Stripe Delete Invoice Items
deleteInvoice ItemsInvoiceitem 1 param body → 200default
GET
/v1/Invoice Items/{invoiceitem}
Stripe Get Invoice Items
getInvoice ItemsInvoiceitem 2 params body → 200default
POST
/v1/Invoice Items/{invoiceitem}
Stripe Post Invoice Items
postInvoice ItemsInvoiceitem 1 param body → 200default
DELETE
/v1/invoices/{invoice}
Stripe Delete Invoices Invoice
deleteInvoicesInvoice 1 param body → 200default
GET
/v1/invoices/{invoice}
Stripe Get Invoices Invoice
getInvoicesInvoice 2 params body → 200default
POST
/v1/invoices/{invoice}
Stripe Post Invoices Invoice
postInvoicesInvoice 1 param body → 200default
POST
/v1/invoices/{invoice}/finalize
Stripe Post Invoices Invoice Finalize
postInvoicesInvoiceFinalize 1 param body → 200default
GET
/v1/invoices/{invoice}/lines
Stripe Get Invoices Invoice Lines
getInvoicesInvoiceLines 5 params body → 200default
POST
/v1/invoices/{invoice}/lines/{line_item_id}
Stripe Post Invoices Invoice Lines Line Item Id
postInvoicesInvoiceLinesLineItemId 2 params body → 200default
POST
/v1/invoices/{invoice}/mark_uncollectible
Stripe Post Invoices Invoice Mark Uncollectible
postInvoicesInvoiceMarkUncollectible 1 param body → 200default
POST
/v1/invoices/{invoice}/pay
Stripe Post Invoices Invoice Pay
postInvoicesInvoicePay 1 param body → 200default
POST
/v1/invoices/{invoice}/send
Stripe Post Invoices Invoice Send
postInvoicesInvoiceSend 1 param body → 200default
POST
/v1/invoices/{invoice}/void
Stripe Post Invoices Invoice Void
postInvoicesInvoiceVoid 1 param body → 200default

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are invoice (81 properties), PostInvoicesInvoiceRequest (24 properties), line_item (23 properties), invoiceitem (22 properties). Each schema is shown below with its type and property counts.

DeleteInvoicesInvoiceRequest
object
GetInvoice_ItemsRequest
object
PostInvoicesInvoiceFinalizeRequest
object
2 properties
GetInvoicesInvoiceLinesRequest
object
PostInvoicesInvoiceSendRequest
object
1 property
PostInvoicesInvoicePayRequest
object
7 properties
InvoicesItemsList
object
4 properties 4 required
PostInvoicesInvoiceRequest
object
24 properties
deleted_invoiceitem
object
3 properties 3 required
GetInvoice_ItemsInvoiceitemRequest
object
deleted_invoice
object
3 properties 3 required
PostInvoicesInvoiceVoidRequest
object
1 property
PostInvoice_ItemsInvoiceitemRequest
object
15 properties
DeleteInvoice_ItemsInvoiceitemRequest
object
PostInvoicesInvoiceMarkUncollectibleRequest
object
1 property
error
object
An error response from the Stripe API
1 property 1 required
invoice
object
Invoices are statements of amounts owed by a customer, and are either generated one-off, or generated periodically from a subscription. They contain [invoice i…
81 properties 26 required
GetInvoicesInvoiceRequest
object
InvoiceLinesList
object
4 properties 4 required
PostInvoicesInvoiceLinesLineItemIdRequest
object
12 properties
line_item
object
23 properties 10 required
invoiceitem
object
Invoice Items represent the component lines of an [invoice](https://stripe.com/docs/api/invoices). An invoice item is added to an invoice by creating or updati…
22 properties 11 required
PostInvoice_ItemsRequest
object
19 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

stripe-invoice-api-openapi.yml Raw ↑

Other APIs Stripe publishes across the network.

Stripe Accounts API
Stripe Balance API
Stripe Billing API
Stripe Charges API
Stripe Checkout API
Stripe Climate API
Stripe Country API
Stripe Coupons API
Stripe Credit Notes API
Stripe Customers API
Stripe Disputes API
Stripe Ephemeral Keys API
Where this information came from

This is an independent, third-party profile of Stripe Invoice API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.