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

# Get credit grants

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

## Request

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

Get credit grants (purchases, rollovers, and refunds) for the specified Organization.

## Path parameters

- `organizationId` string, required

## Response `200`

Credit grants for the current contract.

- CreditGrantsResponseDTO
  - `items` CreditGrantSchema[], required: Credit grants for the current contract. Listed in reverse chronologial order by grant date (newest first).
    - `date` string, date-time, required: Date the grant was issued, in ISO 8601 format.
    - `creditsAcquired` number, required: Number of credits acquired by the grant.
    - `type` 'Refund' | 'Rollover' | 'Purchased', required: Type of the credit grant.
  - `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-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/grants/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)