---
title: "Get credit balance"
method: GET
path: "/api/v1/billing/credits/balance"
tags: ["credit"]
---

# Get credit balance

`GET /api/v1/billing/credits/balance`

## Request

- Base URL: `https://api.bundle.social`
- URL: `https://api.bundle.social/api/v1/billing/credits/balance`
- Auth: API key in header `x-api-key`

Retrieve your organization's prepaid credit balance: settled funds, in-flight holds, and the available amount metered X actions draw from.

## Response `200`

200

- object
  - `organizationId` string, required
  - `currency` 'usd', required
  - `balanceMicros` integer, required
  - `heldMicros` integer, required
  - `availableMicros` integer, required
  - `balanceCents` integer, required
  - `availableCents` integer, required
  - `lowBalanceThresholdMicros` integer, nullable, required
  - `lowBalance` boolean, required
  - `updatedAt` string, date-time, nullable, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429
- `500`: 500
- `502`: 502
- `503`: 503
- `504`: 504

## Changes

- **2026-11-03** `fb6e4fbd8d2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bundle/apis/bundle-social-api/changes/api/v1/billing/credits/balance/get.md)

---

[API](https://skmtc.dev/bundle/apis/bundle-social-api.md) - [All operations](https://skmtc.dev/bundle/apis/bundle-social-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bundle/apis/bundle-social-api/revisions/18efa1cb93a4?raw)