---
title: "Lifetime credit totals for the API user's account."
method: GET
path: "/manage/api/credit_summary"
tags: ["manage"]
---

# Lifetime credit totals for the API user's account.

`GET /manage/api/credit_summary`

Returns the lifetime credit KPIs (consumed, expired, issued) used to
render the API credit dashboard strip. All values default to $0 when
Metronome is unavailable so the FE can always render.

## Query parameters

- `organization_id` string, required

## Response `200`

API credit summary content

- ManageApiCreditSummaryResponse
  - `total_consumed` 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_expired` 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_issued` 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.
  - `credit_grants` CreditGrant[], required — Per-grant breakdown of the user's credit grants. Empty if Metronome is unavailable.
    - `grant_id` string, required — The Metronome grant identifier.
    - `name` string, required — The grant name as shown in Metronome (e.g. "Ideogram API Usage").
    - `amount_issued` 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.
    - `amount_consumed` 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.
    - `amount_available` 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.
    - `effective_at` string, required — ISO-8601 timestamp when the grant becomes effective.
    - `expires_at` string — ISO-8601 timestamp when the grant expires. Omitted if the grant has no expiration.

## Other responses

- `401` — Not authorized
- `403` — Not authorized

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/bd40f367a834/schema)