---
title: "Get the caller's org credit balance"
method: GET
path: "/credits/balance"
tags: ["Credits"]
---

# Get the caller's org credit balance

`GET /credits/balance`

## Request

- Base URL: `https://api-docs.jackhamr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.jackhamr.ai/credits/balance`
- Auth: none declared

Return the org's credit balance, status, and plan info.

Reads through :class:`~app.services.credit_service.CreditService`
which caches the balance in Redis and falls back to PostgreSQL.

## Response `200`

Successful Response

- CreditBalance: Org credit balance as returned by ``GET /api/v1/credits/balance``.
  - `organization_id` string, required
  - `balance` number, required
  - `currency` string
  - `status` string, required
  - `free_signup_credit` number
  - `grace_amount` number
  - `grace_period_days` integer
  - `lifetime_credits_added` number
  - `lifetime_credits_used` number
  - `allowance_used` number
  - `allowance_remaining` number
  - `overage_amount` number
  - `subscription_status` string, nullable
  - `current_period_end` string, date-time, nullable
  - `managed_by` ManagedBy: The partner that funds a wholesale org's credits.
    - `name` string, required
    - `support_email` string, nullable

---

[API](https://skmtc.dev/jackhamr/apis/jackhamr-api.md) · [All operations](https://skmtc.dev/jackhamr/apis/jackhamr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jackhamr/apis/jackhamr-api/revisions/f75d221481d8?raw)