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

# Get Balance

`GET /api/v1/billing/balance`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.mor.org/oauth2/authorize`
    - Token URL: `https://auth.mor.org/oauth2/token` scopes: `aws.cognito.signin.user.admin`, `openid`, `email`, `profile`
  - HTTP bearer

Get current credit balance for the authenticated user.

Authenticate with either a Cognito JWT or an ``sk-…`` API key.

Returns:
- paid: Paid bucket balance (posted, holds, available)
- staking: Staking bucket balance (daily amount, refresh date, available)
- total_available: Sum of all available credits

## Response `200`

Successful Response

- BalanceResponse: Response for GET /billing/balance.
  - `paid` PaidBalanceInfo, required: Paid bucket balance details.
    - `posted_balance` string, required: Posted paid credits balance
    - `pending_holds` string, required: Pending holds (negative)
    - `available` string, required: Available paid credits (posted + holds)
  - `staking` StakingBalanceInfo, required: Staking bucket balance details.
    - `daily_amount` string, required: Configured daily staking allowance
    - `refresh_date` string, date: Last staking refresh date
    - `available` string, required: Currently available staking credits
  - `total_available` string, required: Total available credits (paid + staking)
  - `is_staker` boolean: True if user has linked wallets with active MOR stake.
  - `allow_overage` boolean: Stakers only. When enabled, the system automatically uses your paid Credit Balance after the Daily Staking Allowance is exhausted, preventing service interruption. When disabled, requests will fail once staking credits are depleted. This setting has no effect for non-stakers.
  - `currency` string: Currency code

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/billing/balance/get.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)