---
title: "Get credits timeseries"
method: GET
path: "/v1/organizations/{organizationId}/billing/credits/timeseries"
tags: ["billing"]
---

# Get credits timeseries

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

## Request

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

Get credit consumption timeseries data for the specified Organization, broken down by dimensions such as product and usage type.

## Path parameters

- `organizationId` string, required

## Query parameters

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

## Response `200`

Credits timeseries data.

- CreditsTimeseriesResponseDTO
  - `items` CreditsTimeseriesItemSchema[], required: Credit timeseries data points.
    - `date` string, date-time, required: Date of the aggregation window in ISO 8601 format.
    - `credits` number, required: Total credits consumed in the aggregation window.
    - `dimensions` CreditsTimeseriesDimensionSchema[], required: Credit breakdown by dimension.
      - `dimension` string, required: Dimension label for the credit breakdown.
      - `credits` number, required: Number of credits attributed to the dimension.
  - `count` integer, required: Total number of items in the response.

## 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/timeseries/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)