List invoices

GET

https://api.ideogram.ai/v2/account/invoices

GET

/v2/account/invoices

curl https://api.ideogram.ai/v2/account/invoices \
     -H "Api-Key: <apiKey>"

{
  "invoices": [
    {
      "start_time": "2024-01-15T09:30:00Z",
      "end_time": "2024-01-15T09:30:00Z",
      "status": "paid",
      "total": "150.00",
      "currency_code": "USD",
      "line_items": [
        {
          "description": "Ideogram v4 Generation",
          "quantity": "2100",
          "unit_price": "0.04",
          "cost_total": "84.00",
          "currency_code": "USD",
          "api_key": {
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "redacted_key": "ATG5•••••••••••••",
            "label": "Live production environment"
          }
        },
        {
          "description": "Ideogram v4 Generation",
          "quantity": "2100",
          "unit_price": "0.04",
          "cost_total": "84.00",
          "currency_code": "USD",
          "api_key": {
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "redacted_key": "ATG5•••••••••••••",
            "label": "Live production environment"
          }
        }
      ],
      "issued_time": "2024-01-15T09:30:00Z",
      "paid_time": "2024-01-15T09:30:00Z"
    },
    {
      "start_time": "2024-01-15T09:30:00Z",
      "end_time": "2024-01-15T09:30:00Z",
      "status": "paid",
      "total": "150.00",
      "currency_code": "USD",
      "line_items": [
        {
          "description": "Ideogram v4 Generation",
          "quantity": "2100",
          "unit_price": "0.04",
          "cost_total": "84.00",
          "currency_code": "USD",
          "api_key": {
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "redacted_key": "ATG5•••••••••••••",
            "label": "Live production environment"
          }
        },
        {
          "description": "Ideogram v4 Generation",
          "quantity": "2100",
          "unit_price": "0.04",
          "cost_total": "84.00",
          "currency_code": "USD",
          "api_key": {
            "id": "JRPVD7jWR1aTBYiJ0UFVOg",
            "redacted_key": "ATG5•••••••••••••",
            "label": "Live production environment"
          }
        }
      ],
      "issued_time": "2024-01-15T09:30:00Z",
      "paid_time": "2024-01-15T09:30:00Z"
    }
  ]
}

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.

Authentication

Api-Keystring

API key for access control. Use in the header with the name "Api-Key"

Response

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

invoiceslist of objects

The organization's invoices.

Errors

401

Unauthorized Error

404

Not Found Error