Usage

Get credit usage

Billing view of the organization's credit consumption, broken down by billable operation and by day, with rate-card pricing.

Requires an org-scoped API key: credit usage is an organization-level concern. User-scoped keys receive a 403.

If rate-card pricing can't be resolved for every observed operation, pricing_available is false and all credit fields are null; raw request counts are still returned.

get/credit-usage

Request

Base URL
https://app.gc.ai/api/external/v1
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/gc-ai/apis/gc-ai-external-api/docs/credit-usage/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

start_datestring required

Inclusive range start (YYYY-MM-DD).

Example:2026-06-01

end_datestring required

Inclusive range end (YYYY-MM-DD).

Example:2026-06-30

timezonestring

IANA timezone for day boundaries (default UTC), e.g. America/New_York.

Response

Credit usage for the requested range

start_datestring required

Inclusive range start.

end_datestring required

Inclusive range end.

timezonestring required

IANA timezone used for day boundaries.

pricing_availableboolean required

Whether rate-card pricing could be resolved for every observed operation. When false, all credit fields are null and only raw request counts are returned.

total_creditsnumber nullable required

Total credits across all operations over the range. Null when pricing is unavailable.

Example response

{
  "lines": [
    {
      "api": "chat:completions"
    }
  ],
  "daily": [
    {
      "date": "2026-06-01"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.