---
title: "List your organization's invoices"
method: GET
path: "/v2/account/invoices"
tags: ["account"]
---

# List your organization's invoices

`GET /v2/account/invoices`

Returns your organization's invoices with their line items — the
billing record your usage reports reconcile against. Amounts are
decimal strings in the invoice's currency.

Requires an API key whose owner is an organization admin. Keys owned
by other members receive a 404.

## Response `200`

The organization's invoices. Empty when no billing history exists yet.

- ListAccountInvoicesResponse
  - `invoices` AccountInvoice[], required — The organization's invoices.
    - `start_time` string, date-time, required — Start of the invoice period.
    - `end_time` string, date-time, required — End of the invoice period.
    - `issued_time` string, date-time, nullable — When the invoice was issued, when it has been.
    - `paid_time` string, date-time, nullable — When the invoice was paid, when it has been.
    - `status` 'draft' | 'pending_payment' | 'paid' | 'voided', required — Status of the invoice
    - `total` string, required — Invoice total in `currency_code`, as a decimal string.
    - `currency_code` string, required — ISO 4217 currency code of the amounts on this invoice.
    - `line_items` AccountInvoiceLineItem[], required — The invoice's charges.
      - `description` string, required — Display name of the charged product. Not an identifier.
      - `quantity` string, required — Number of billed units, as a decimal string.
      - `unit_price` string, required — Price per unit in `currency_code`, as a decimal string.
      - `cost_total` string, required — Total charged amount in `currency_code`, as a decimal string.
      - `currency_code` string, required — ISO 4217 currency code of the amounts on this line item.
      - `api_key` AccountUsageApiKey — The API key the usage was billed to, in redacted form.
        - `id` string, required — The API key's id, as listed by `GET /v2/account/api-keys`.
        - `redacted_key` string, nullable — The first characters of the key followed by bullets.
        - `label` string, nullable — The key's user-supplied label, when one is set.

## Other responses

- `401` — Unauthorized.
- `404` — No organization with billing access was found for this credential.

## Changes

- **2026-09-19** `4e95197be44a` — 4 warning, 4 info
  - added the new `draft` enum value to the `invoices/items/status` response property for the response status `200`
  - added the new `paid` enum value to the `invoices/items/status` response property for the response status `200`
  - added the new `pending_payment` enum value to the `invoices/items/status` response property for the response status `200`
  - added the new `voided` enum value to the `invoices/items/status` response property for the response status `200`
  - …4 more
- **2026-09-10** `185ac0b0801d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/changes/v2/account/invoices/get.md)

---

[API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/revisions/4e95197be44a?raw)