---
title: "Read the organization's spend budget"
method: GET
path: "/organizations/{organizationId}/spend-budget"
tags: ["Catalog"]
---

# Read the organization's spend budget

`GET /organizations/{organizationId}/spend-budget`

The ceiling on what this organization may spend on MCPJam-billed work — chat, evals, judges and computer time — in the current billing window, and how much of it has been spent.

Any member may read it: a member who cannot raise the ceiling still needs to know it exists, because it is what refused their run. `capUsd: null` means the organization is uncapped, which is the default.

Runs that use your own provider keys are never counted against the budget and never blocked by it. Neither is the free daily allowance — it is not credits.

## Response `200`

The organization's spend budget.

- SpendBudget — An organization's ceiling on MCPJam-billed spend for the current billing window. Amounts appear in both USD and credits (1 credit = 1 cent); the credit figures are what the ledger actually stores.
  - `capUsd` number, nullable, required — The ceiling in USD. `null` means uncapped.
  - `capCredits` integer, nullable, required — The same ceiling as the ledger stores it.
  - `alertPercents` integer[], required — Whole percents of the cap that notify owners and admins. Reaching the cap always notifies, whether or not 100 is listed.
  - `spentUsd` number, required — MCPJam-billed spend so far in this window, in USD.
  - `spentCredits` integer, required — The same spend as the ledger counted it.
  - `windowStartAt` integer, required — Start of the current billing window (epoch ms). Team and enterprise organizations run on their own subscription cycle; everyone else on the UTC month.
  - `windowEndsAt` integer, required — When the window resets and the counter returns to zero (epoch ms).
  - `alertedPercents` integer[], required — Thresholds already announced this window. Each fires once per window.
  - `capReachedAt` integer, nullable, required — When the cap was reached this window, or `null`.
  - `updatedAt` integer, nullable, required — When the budget was last changed (epoch ms).
  - `minCapUsd` number, required — The smallest budget the platform accepts.
  - `maxCapUsd` number, required — The largest budget the platform accepts.
  - `supported` boolean, required — False for a personal organization, which cannot have a budget.

## Other responses

- `401` — Missing, invalid, revoked, or orphaned key (`UNAUTHORIZED`) — or the **target MCP server** needs an OAuth grant (`OAUTH_REQUIRED`), which is a property of the server, not your key.
- `403` — Key is valid but not allowed to do this.
- `404` — Unknown project, server, or resource.
- `429` — Per-key rate limit exceeded (60 requests/minute sustained, bursts up to 10). Honor `Retry-After` and back off with jitter.
- `500` — Something failed on MCPJam's side.

## Changes

- **2026-09-07** `417b6d81e434` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mcpjam/apis/mcpjam-api/changes/organizations/:organizationId/spend-budget/get.md)

---

[API](https://skmtc.dev/mcpjam/apis/mcpjam-api.md) · [All operations](https://skmtc.dev/mcpjam/apis/mcpjam-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mcpjam/apis/mcpjam-api/revisions/9b4860d5945e?raw)