---
title: "Retrieve an organization's credit balance"
method: GET
path: "/organizations/{organization_id}/billing/credits"
tags: ["Organizations", "Billing"]
---

# Retrieve an organization's credit balance

`GET /organizations/{organization_id}/billing/credits`

## Request

- Base URL: `https://api.clerk.com/v1`
- URL: `https://api.clerk.com/v1/organizations/{organization_id}/billing/credits`
- Auth: HTTP bearer

Retrieves the current credit balance for the specified organization.
Credits can be applied during checkout to reduce the charge or automatically applied to upcoming recurring charges.

## Path parameters

- `organization_id` string, required

## Response `200`

A payer's credit balance.

- CommerceCreditBalanceResponse
  - `object` string, required: String representing the object's type. Always "commerce_credit_balance".
  - `balance` CommerceMoneyResponse, required
    - `amount` integer, required: The amount in cents.
    - `amount_formatted` string, required: The formatted amount as a string (e.g., "$49.99").
    - `currency` string, required: The currency code (e.g., "USD").
    - `currency_symbol` string, required: The currency symbol (e.g., "$").

## Other responses

- `400`: Request was not successful
- `401`: Authentication invalid
- `403`: Authorization invalid
- `404`: Resource not found
- `422`: Invalid request parameters
- `500`: Request was not successful

## Changes

- **2026-03-06** (2025-11-10) `42e3e85e75f8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/organizations/:organization_id/billing/credits/get.md)

---

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