v5

OpenAPI 3.1.02026-08-025631,1012.8 MB

Organization Billing

List Invoices

List monthly invoices.

Returns paginated list of monthly invoices with links to Stripe-hosted invoice pages.

Query Parameters:

limit: Number of invoices (1-100, default 10)

Requirements:

Read permission

Example:

response = await client.get("/v1/organizations/billing/invoices?limit=10")
for invoice in response["invoices"]:
    print(f"{invoice['billing_month']}: ${invoice['amount_paid']/100}")

get/v1/organizations/billing/invoices

Query parameters

limitinteger

Number of invoices to return

Response

Successful Response

totalinteger required

Total number of invoices

has_moreboolean required

Whether there are more invoices

Example response

{
  "invoices": [
    {
      "invoice_id": "in_1ABC2DEF3GHI",
      "invoice_url": "https://invoice.stripe.com/i/inv_1ABC2DEF3GHI",
      "invoice_pdf": "https://invoice.stripe.com/i/inv_1ABC2DEF3GHI/pdf",
      "amount_due": 2345,
      "amount_paid": 2345,
      "status": "paid",
      "billing_month": "2025-11",
      "total_credits": 23450
    }
  ]
}