---
title: "Get contract credit utilization"
method: GET
path: "/v1/organizations/{organizationId}/billing/credits/contracts-utilization"
tags: ["billing"]
---

# Get contract credit utilization

`GET /v1/organizations/{organizationId}/billing/credits/contracts-utilization`

## Request

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

Get cumulative credit utilization data grouped by contract period for the specified Organization.

## Path parameters

- `organizationId` string, required

## Query parameters

- `startingOn` string, date-time, required
- `endingBefore` string, date-time, required
- `window` 'monthly' | 'daily', required

## Response `200`

Contract credit utilization data.

- ContractsUtilizationResponseDTO
  - `contracts` ContractUtilizationSchema[], required: Contract utilization data, grouped by contract period.
    - `contractStartDate` string, date-time, required: Contract start date in ISO 8601 format.
    - `contractEndDate` string, date-time: Contract end date in ISO 8601 format. Present only when the contract is closed.
    - `items` CreditsUtilizationItemSchema[], required: Cumulative credit utilization entries for the contract.
      - `date` string, date-time, required: Date of the aggregation window in ISO 8601 format.
      - `credits` number, required: Number of credits consumed in the aggregation window.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-05** `78226a018c73`: 1 info
  - removed the non-success response with the status `503`
- **2026-08-25** `60802a563427`: 1 info
  - endpoint added
- **2026-08-24** `03221f2a3cf6`: 1 breaking
  - api path removed without deprecation
- **2026-07-27** `142869331eab`: 1 info
  - endpoint added
- **2026-07-23** `53d0b0012c3a`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/criblio/apis/cribl-cloud-public-api/changes/v1/organizations/:organizationId/billing/credits/contracts-utilization/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)