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

# List Invoices

`GET /v1/organizations/billing/invoices`

## Request

- Base URL: `https://api.mixpeek.com`
- URL: `https://api.mixpeek.com/v1/organizations/billing/invoices`
- Auth: HTTP bearer

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`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `success` to the response with the `422` status
  - …2 more
- **2026-08-09** `5d4c905106b4`: 1 info
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-08-06** `aefce63dddc6`: 3 info
  - added the optional property `invoices/items/cloud_fee_cents` to the response with the `200` status
  - added the optional property `invoices/items/platform_fee_billed_externally` to the response with the `200` status
  - added the optional property `invoices/items/platform_fee_cents` to the response with the `200` status

[Operation history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/organizations/billing/invoices/get.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) - [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixpeek/apis/mixpeek-api/revisions/790bc16455f6?raw)