---
title: "Retrieve invoices for a specific organization"
method: GET
path: "/manage/api/organization/list_invoices"
tags: ["manage"]
---

# Retrieve invoices for a specific organization

`GET /manage/api/organization/list_invoices`

## Query parameters

- `organization_id` string, required

## Response `200`

Invoices retrieved successfully

- ListOrganizationInvoicesResponse
  - `invoices` Invoice[], required — List of invoices
    - `invoice_id` string, nullable — The invoice ID in Metronome
    - `start_time` string, date-time, required — The start time of the invoice period
    - `end_time` string, date-time, required — The end time of the invoice period
    - `issued_time` string, date-time, nullable — The date when the invoice was issued
    - `paid_date` string, date-time, nullable — The date when the invoice was marked paid in Metronome
    - `total_spend` Price, required — Represents a price.
      - `currency_code` string, required — The ISO 4217 currency code for the price object.
      - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.
    - `invoice_status` 'DRAFT' | 'PENDING_PAYMENT' | 'PAID' | 'VOIDED', required — Status of the invoice
    - `line_items` InvoiceLineItem[], required — A list of line items within the invoice
      - `charge_name` string, required — The name of the charge
      - `api_key_id` string, nullable — The API key associated with the usage, when available
      - `quantity` integer, required — The quantity of the charge
      - `unit_price` Price, required — Represents a price.
        - `currency_code` string, required — The ISO 4217 currency code for the price object.
        - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.
      - `total` Price, required — Represents a price.
        - `currency_code` string, required — The ISO 4217 currency code for the price object.
        - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.

## Other responses

- `401` — Not authorized
- `403` — Not authorized
- `404` — Organization not found

---

[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-service-production.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/3eb3216eed39/schema)