Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/useautumn/autumn/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve a single invoice by its Stripe invoice ID. This endpoint returns the raw Stripe invoice object.
This is a read-only endpoint. Invoices are automatically created when customers subscribe to plans or make payments through the billing system.

​
Path Parameters

​
id
string
required
The Stripe invoice ID (e.g., in_1A2B3C4D5E6F7G8H)

​
Response

Returns a Stripe invoice object with the following key properties:
​
id
string
The Stripe invoice ID
​
customer
string
The Stripe customer ID
​
status
string
The invoice status. Possible values: draft, open, paid, void, uncollectible
​
total
number
The total amount in cents
​
currency
string
Three-letter ISO currency code (e.g., usd)
​
created
number
Timestamp when the invoice was created (Unix timestamp in seconds)
​
hosted_invoice_url
string | null
URL to the Stripe-hosted invoice page where customers can view and pay
​
lines
object
Line items included in the invoice
​
subscription
string | null
The Stripe subscription ID if this invoice is for a subscription
​
discount
object | null
Any discount applied to the invoice
{
  "id": "in_1A2B3C4D5E6F7G8H",
  "object": "invoice",
  "customer": "cus_123456",
  "status": "paid",
  "total": 2999,
  "currency": "usd",
  "created": 1759247877,
  "hosted_invoice_url": "https://invoice.stripe.com/i/acct_123/test_456",
  "subscription": "sub_1A2B3C4D5E6F7G8H",
  "lines": {
    "data": [
      {
        "id": "il_1A2B3C4D5E6F7G8H",
        "description": "Pro Plan × 1",
        "amount": 2999,
        "currency": "usd",
        "quantity": 1,
        "period": {
          "start": 1759247877,
          "end": 1761926277
        }
      }
    ]
  }
}

​
Common Use Cases

const invoice = await fetch('https://api.autumn.com/v1/invoices/in_1A2B3C4D5E6F7G8H', {
  headers: {
    'Authorization': `Bearer ${process.env.AUTUMN_SECRET_KEY}`
  }
});

const data = await invoice.json();
console.log(`Invoice ${data.id}: ${data.status}`);

Build docs developers (and LLMs) love

Get started for freeTalk to us