---
title: "Get credit balance and consumption"
method: GET
path: "/v1/organizations/{organizationId}/billing/credits/stats"
tags: ["billing"]
---

# Get credit balance and consumption

`GET /v1/organizations/{organizationId}/billing/credits/stats`

## Request

- Base URL: `https://gateway.cribl.cloud`
- URL: `https://gateway.cribl.cloud/v1/organizations/{organizationId}/billing/credits/stats`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://login.cribl.cloud/oauth/token`
  - HTTP bearer

Get credit balance totals, consumption totals, and contract date ranges for the specified Organization.

## Path parameters

- `organizationId` string, required

## Response `200`

Credit balance and consumption totals.

- CreditsStatsResponseDTO
  - `totalCreditsRemaining` number, required: Credits remaining under the current contract.
  - `totalCreditsUsed` number, required: Credits consumed under the current contract.
  - `totalCreditsAcquired` number, required: Credits acquired under the current contract.
  - `contracts` CreditsStatsContractSchema[]: All contracts for the Organization, ordered by contract start date in reverse chronological order (newest first).
    - `startDate` string, date-time, required: Contract start date in ISO 8601 format.
    - `endDate` string, date-time: Contract end date in ISO 8601 format. Present only when the contract is closed.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-05** `78226a018c73`: 1 info
  - removed the non-success response with the status `503`
- **2026-09-04** `33ff494592e1`: 2 warning
  - deleted the `query` request parameter `endingBefore`
  - deleted the `query` request parameter `startingOn`
- **2026-08-25** `60802a563427`: 1 info
  - endpoint added
- **2026-08-24** `03221f2a3cf6`: 1 breaking
  - api path removed without deprecation
- **2026-08-20** `6b74b2f0e495`: 1 warning
  - deleted the `query` request parameter `window`

[Operation history](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/changes/v1/organizations/:organizationId/billing/credits/stats/get.md)

---

[API](https://skmtc.dev/criblio/apis/cribl-cloud-public-api.md) - [All operations](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/revisions/78226a018c73?raw)