---
title: "Get Organization Balance"
method: GET
path: "/v1/organization/balance"
tags: ["Organization"]
---

# Get Organization Balance

`GET /v1/organization/balance`

## Request

- Base URL: `https://api.quiver.ai`
- URL: `https://api.quiver.ai/v1/organization/balance`
- Auth: HTTP bearer

Requires an admin API key with billing_read or * authority. Returns the authenticated organization's spendable credits across all projects. Pending reservations, expired funding, and refunds are excluded. The balance is a JSON number with up to three fractional digits; very large balances may lose floating-point precision. This is a snapshot and may change after the response. The organization's request-rate limit applies and may return 429.

## Response `200`

Spendable organization credit balance

- object
  - `object` 'organization.balance', required
  - `organization_id` string, required
  - `available_credits` number, required
  - `observed_at` integer, required

## Other responses

- `401`: Unauthorized – missing, malformed, disabled, or invalid API credentials or organization identity.
- `403`: Forbidden – the credential lacks admin billing_read authority or the organization is suspended.
- `429`: Rate limit exceeded – the organization's request-rate ceiling was reached. Retry after the period indicated by Retry-After.
- `500`: The organization balance could not be read. Please retry.

## Changes

- **2026-09-30** `b2283e5339fe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quiver/apis/quiverai-api/changes/v1/organization/balance/get.md)

---

[API](https://skmtc.dev/quiver/apis/quiverai-api.md) - [All operations](https://skmtc.dev/quiver/apis/quiverai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/quiver/apis/quiverai-api/revisions/5db9b140be5c?raw)
