---
title: "Org balance + recent transactions"
method: GET
path: "/v1/orgs/{orgId}/billing/balance"
tags: ["Billing"]
---

# Org balance + recent transactions

`GET /v1/orgs/{orgId}/billing/balance`

## Path parameters

- `orgId` string, required

## Response `200`

Balance

- Balance
  - `accruedUsageCents` integer, required — Usage cost not yet settled into a transaction: the current month, plus any recently ended month whose settlement debit has not been written yet (briefly higher than currentMonthUsageCents right after a month rollover).
  - `availableCents` integer, required — Spendable balance = balanceCents − accruedUsageCents. This is what the deploy gate checks; it can be below balanceCents while usage is running, and slightly negative between auto-recharge ticks.
  - `balanceCents` integer, required — Raw ledger balance (deposits + credits − settled debits).
  - `currentMonthUsageCents` integer, required — Usage cost accrued in the current calendar month only. Use this for "spend this month" displays; use accruedUsageCents for balance math.
  - `monthlySpendLimitCents` integer, nullable — The org's monthly spend cap, or null if no limit is set. Drives the "used of limit" budget gauge in the dashboard.
  - `transactions` Transaction[], required
    - `amountCents` integer, required
    - `createdAt` string, required
    - `description` string
    - `id` string, required
    - `inferenceDetails` InferenceTransactionDetails
      - `carriedNanoUSD` string, required — Customer charge represented by these metered requests that remains as sub-cent accrual for a later debit.
      - `models` InferenceModelUsage[], required
        - `batch` boolean, required
        - `dimensions` object, required — Exact decimal token quantities. Current keys are input, cached_input, cache_write, and output; the map shape reserves room for future metered units.
        - `model` string, required
        - `requestCount` string, required — Exact decimal count; encoded as a string so browser clients do not lose int64 precision.
      - `partial` boolean, required — True when some of the debit is not itemized in this row, including legacy usage or sub-cent cost carried from a prior row.
    - `source` string, required
    - `type` string, required

## Other responses

- `401` — Missing or invalid API key
- `403` — API key lacks the required scope

---

[API](https://skmtc.net/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.net/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openrelay/openrelay-api/versions/32905b8f44f8/schema)