---
title: "GET /orgs/{org_id}/credit-grants"
method: GET
path: "/orgs/{org_id}/credit-grants"
tags: ["billing"]
---

# GET /orgs/{org_id}/credit-grants

`GET /orgs/{org_id}/credit-grants`

Credit grants awarded to an organization, most recent first.

## Path parameters

- `org_id` string, required

## Response `200`

Credit grants for the organization

- ListCreditGrantsResBody
  - `credit_grants` CreditGrant[], required
    - `amount_credits` integer, required — Credits awarded by this grant. Always positive; corrections ship as a separate grant rather than a negative amount.
    - `consumed_credits` integer, required — Credits already drawn from this grant by attributed costs. Bounded by `amount_credits`; remaining headroom is `amount_credits - consumed_credits`.
    - `created_at` string, date-time, required — Grant creation timestamp.
    - `exhausted_at` string, date-time, nullable — Set once the grant has been fully consumed by usage; `null` while the grant still has unspent credits or hasn't been reconciled yet.
    - `expires_at` string, date-time, nullable — When the grant stops being spendable. `null` = never expires.
    - `granted_by_user_id` integer, nullable — User who triggered the grant. `null` for system-issued grants.
    - `source` string, required — Where the grant came from (e.g. `onboarding`, `promo`, `support`, `referral`, `refund`).
    - `source_metadata` unknown, required
    - `starts_at` string, date-time, required — When the grant became (or will become) spendable.
    - `uid` string, uuid, required — Stable public identifier for this grant.

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.net/timbal-ai/apis/timbal-platform-api.md) · [All operations](https://skmtc.net/timbal-ai/apis/timbal-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timbal-ai/timbal-platform-api/revisions/dd7e398ce0d3/schema)