Get Invoice

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

Show properties

data · object[]

Array of invoice line items

Show properties

id · string

The line item ID

description · string

Description of the line item

amount · number

Amount in cents

currency · string

Currency code

quantity · number

Quantity of items

period · object

Billing period for this line item

Show properties

start · number

Period start timestamp (Unix timestamp in seconds)

end · number

Period end timestamp (Unix timestamp in seconds)

subscription · string | null

The Stripe subscription ID if this invoice is for a subscription

discount · object | null

Any discount applied to the invoice

200

{
  "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

Get invoice details

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}`);

import requests

response = requests.get(
    'https://api.autumn.com/v1/invoices/in_1A2B3C4D5E6F7G8H',
    headers={'Authorization': f'Bearer {os.environ["AUTUMN_SECRET_KEY"]}'}
)

invoice = response.json()
print(f"Invoice {invoice['id']}: {invoice['status']}")