---
title: "Read credit usage"
method: GET
path: "/v1/billing/credit-usage"
tags: ["Billing"]
---

# Read credit usage

`GET /v1/billing/credit-usage`

## Request

- Base URL: `https://api.inth.com`
- URL: `https://api.inth.com/v1/billing/credit-usage`
- Auth: HTTP bearer

Requires billing.read and organization owner access. Settled charges with product, activity, grouping and member or automation attribution. This shared history covers the last 30 days, five receipts per page, and is not the lifetime ledger. An unavailable ledger returns 503.

## Query parameters

- `organizationId` string
- `page` integer

## Response `200`

Read credit usage

- object
  - `success` true, required
  - `data` BillingCreditUsage, required
    - `organizationId` string, required
    - `creditUsage` union, required
      - object
        - `status` 'error', required
      - object
        - `items` object[], required
          - `activity` string, required
          - `credits` integer, required
          - `detail` string, nullable, required
          - `groupKey` string, nullable
          - `href` string, nullable, required
          - `id` string, required
          - `initiatedBy` object, required
            - `label` string, required
            - `type` 'automation' | 'former-member' | 'member' | 'system', required
          - `product` 'agent' | 'code-audit' | 'website-audit', required
          - `productLabel` 'Agent' | 'Inth Code Audit' | 'Website Audit', required
          - `settledAt` string, required
        - `page` integer, required
        - `pageSize` integer, required
        - `periodDays` integer, required
        - `status` 'ready', required
        - `totalItems` integer, required
        - `totalPages` integer, required
        - `totals` object[], required
          - `credits` integer, required
          - `product` 'agent' | 'code-audit' | 'website-audit', required
          - `productLabel` 'Agent' | 'Inth Code Audit' | 'Website Audit', required

## Other responses

- `400`: The request payload or parameters are invalid.
- `401`: Authentication is missing, invalid, or expired.
- `403`: The credential is valid but may not perform the operation. `INSUFFICIENT_SCOPE`: the credential was never granted the capability the operation needs. `details.requiredScope` names it, and the `WWW-Authenticate` header carries `Bearer error="insufficient_scope"`. An OAuth client fixes this by requesting the scope; an organization API key cannot gain it. `FORBIDDEN`: the capability is present but the membership behind the credential lacks the role, or the resource belongs to another organization.
- `404`: The requested resource was not found.
- `503`: The capability is temporarily paused by an operator. Retry later.

## Changes

- **2026-10-31** `a3f4100e14c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inth/apis/inth-api/changes/v1/billing/credit-usage/get.md)

---

[API](https://skmtc.dev/inth/apis/inth-api.md) - [All operations](https://skmtc.dev/inth/apis/inth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inth/apis/inth-api/revisions/8741280c3463?raw)