account

List your organization's 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.

get/v2/account/invoices

Response

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

Example response

{
  "invoices": [
    {
      "start_time": "2000-01-23T04:56:07+00:00",
      "total": "150.00",
      "paid_time": "2000-01-23T04:56:07+00:00",
      "end_time": "2000-01-23T04:56:07+00:00",
      "line_items": [
        {
          "cost_total": "84.00",
          "quantity": "2100",
          "api_key": {
            "redacted_key": "ATG5•••••••••••••",
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "label": "Live production environment"
          },
          "description": "Ideogram v4 Generation",
          "unit_price": "0.04",
          "currency_code": "USD"
        },
        {
          "cost_total": "84.00",
          "quantity": "2100",
          "api_key": {
            "redacted_key": "ATG5•••••••••••••",
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "label": "Live production environment"
          },
          "description": "Ideogram v4 Generation",
          "unit_price": "0.04",
          "currency_code": "USD"
        }
      ],
      "issued_time": "2000-01-23T04:56:07+00:00",
      "currency_code": "USD",
      "status": "paid"
    },
    {
      "start_time": "2000-01-23T04:56:07+00:00",
      "total": "150.00",
      "paid_time": "2000-01-23T04:56:07+00:00",
      "end_time": "2000-01-23T04:56:07+00:00",
      "line_items": [
        {
          "cost_total": "84.00",
          "quantity": "2100",
          "api_key": {
            "redacted_key": "ATG5•••••••••••••",
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "label": "Live production environment"
          },
          "description": "Ideogram v4 Generation",
          "unit_price": "0.04",
          "currency_code": "USD"
        },
        {
          "cost_total": "84.00",
          "quantity": "2100",
          "api_key": {
            "redacted_key": "ATG5•••••••••••••",
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "label": "Live production environment"
          },
          "description": "Ideogram v4 Generation",
          "unit_price": "0.04",
          "currency_code": "USD"
        }
      ],
      "issued_time": "2000-01-23T04:56:07+00:00",
      "currency_code": "USD",
      "status": "paid"
    }
  ]
}

Changes

Changed in 2 of the 34 revisions of this API.45

Sep 19, 20264e95197be44a44See the full diff
- ●
  added the new draft enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new paid enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new pending_payment enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new voided enum value to the // response property for the response status
  response-property-enum-value-added
- ○
  removed the DRAFT enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the PAID enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the PENDING_PAYMENT enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  removed the VOIDED enum value from the // response property for the response status
  response-property-enum-value-removed
This revision also has 13 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 10, 2026185ac0b0801d1See the full diff
- ○
  endpoint added
  endpoint-added

Full history