Sign in
Catalog

Read the organization's 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.

get/organizations/{organizationId}/spend-budget

Response

The organization's spend budget.

capUsdnumber nullable required

The ceiling in USD. null means uncapped.

capCreditsinteger nullable required

The same ceiling as the ledger stores it.

alertPercentsinteger[] required

Whole percents of the cap that notify owners and admins. Reaching the cap always notifies, whether or not 100 is listed.

spentUsdnumber required

MCPJam-billed spend so far in this window, in USD.

spentCreditsinteger required

The same spend as the ledger counted it.

windowStartAtinteger 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.

windowEndsAtinteger required

When the window resets and the counter returns to zero (epoch ms).

alertedPercentsinteger[] required

Thresholds already announced this window. Each fires once per window.

capReachedAtinteger nullable required

When the cap was reached this window, or null.

updatedAtinteger nullable required

When the budget was last changed (epoch ms).

minCapUsdnumber required

The smallest budget the platform accepts.

maxCapUsdnumber required

The largest budget the platform accepts.

supportedboolean required

False for a personal organization, which cannot have a budget.

Changes