---
title: "List Invoices"
method: GET
path: "/v1/organizations/billing/invoices"
tags: ["Organization Billing"]
---

# List Invoices

`GET /v1/organizations/billing/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:**
```python
response = await client.get("/v1/organizations/billing/invoices?limit=10")
for invoice in response["invoices"]:
    print(f"{invoice['billing_month']}: ${invoice['amount_paid']/100}")
```

## Query parameters

- `limit` integer — Number of invoices to return

## Response `200`

Successful Response

- InvoiceListResponse — Response with list of invoices.
  - `invoices` InvoiceInfo[] — List of invoices
    - `invoice_id` string, required — Stripe Invoice ID
    - `invoice_url` string, nullable — Stripe-hosted invoice URL (None if not yet finalized)
    - `invoice_pdf` string, nullable — PDF download URL (None if not yet finalized)
    - `amount_due` integer, required — Amount due in cents
    - `amount_paid` integer, required — Amount paid in cents
    - `status` string, required — Invoice status
    - `billing_month` string, required — Billing month (YYYY-MM)
    - `total_credits` integer, required — Total credits billed
    - `created` string, date-time, required — When invoice was created
    - `paid_at` string, date-time, nullable — When invoice was paid
    - `platform_fee_cents` integer, nullable — Monthly platform fee component in cents (delineated)
    - `cloud_fee_cents` integer, nullable — Cloud passthrough + markup (platform_fee mode) or metered usage (platform_only mode) component in cents
    - `platform_fee_billed_externally` boolean, nullable — True when the platform fee is settled outside this system — it is then excluded from amount_due and should render as 'billed externally' rather than unpaid
  - `total` integer, required — Total number of invoices
  - `has_more` boolean, required — Whether there are more invoices

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/5307993e44d3/schema)