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
The Stripe invoice ID (e.g., in_1A2B3C4D5E6F7G8H)
Response
Returns a Stripe invoice object with the following key properties:
The invoice status. Possible values: draft, open, paid, void, uncollectible
The total amount in cents
Three-letter ISO currency code (e.g., usd)
Timestamp when the invoice was created (Unix timestamp in seconds)
URL to the Stripe-hosted invoice page where customers can view and pay
Line items included in the invoice
Array of invoice line items
Description of the line item
Billing period for this line item
Period start timestamp (Unix timestamp in seconds)
Period end timestamp (Unix timestamp in seconds)
The Stripe subscription ID if this invoice is for a subscription
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}`);