---
title: "List Credit Grants"
method: GET
path: "/v1/account/billing/credit-grants"
tags: ["v1"]
---

# List Credit Grants

`GET /v1/account/billing/credit-grants`

## Request

- Base URL: `https://api.ellipsis.dev`
- URL: `https://api.ellipsis.dev/v1/account/billing/credit-grants`
- Auth: HTTP bearer

List your confirmed credit grants and reversals.

Returns only your account's grants. The total is before usage;
/v1/account/budget reports the available balance.

## Headers

- `user-agent` string, nullable

## Response `200`

Successful Response

- CreditGrantsResponse
  - `grants` CreditGrant[], required
    - `amount` integer, required: Granted credit. It is negative for a reversal.
    - `category` 'promotional' | 'paid', required: `promotional` is free credit (signup, comps, migration make-good); `paid` is purchased credit.
    - `created_at` string, date-time, required
    - `id` string, required
    - `name` string, required
    - `source` 'signup' | 'adhoc' | 'purchase' | 'auto_recharge' | 'migration' | 'refund_reversal' | 'yc_deal', required: Why the grant was issued — for analytics and audit, not for enforcement.
  - `total_granted` integer, required: Sum of grants before usage. Read the current balance from /v1/account/budget.

## Other responses

- `401`: The bearer token is missing, invalid, or revoked.
- `403`: The credential may not perform this action, or the account is blocked.
- `422`: Validation Error

---

[API](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api.md) - [All operations](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/revisions/344b16df9a1a?raw)