Get Spending Caps

Get current spending cap configuration.

Returns spending cap settings including budget limits, alert thresholds, and current spending status.

Requirements:

• Read permission

Example:

response = await client.get("/v1/organizations/billing/spending-caps")
print(f"Monthly budget: ${response['monthly_spending_budget_usd']}")
print(f"Hard cap enabled: {response['hard_cap_enabled']}")
print(f"Current spending: ${response['current_spending_usd']}")

GET /v1/organizations/billing/spending-caps

Get Spending Caps

cURL

curl --request GET \
  --url https://api.mixpeek.com/v1/organizations/billing/spending-caps \
  --header 'Authorization: Bearer <token>'

200

{
  "current_spending_cents": 123,
  "current_spending_usd": 123,
  "monthly_spending_budget": 10000,
  "monthly_spending_budget_usd": 100,
  "spending_alert_thresholds": [
    123
  ],
  "spending_alerts_enabled": true,
  "spending_alerts_sent": [
    123
  ],
  "hard_spending_cap": 50000,
  "hard_spending_cap_usd": 500,
  "hard_cap_enabled": false,
  "budget_percentage_used": 46.9
}

Authorizations

Authorization · string · header · required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Response

200

application/json

Successful Response

Response with spending cap configuration.

current_spending_cents · integer · required

Current spending in current billing cycle (cents)

Example:

23450

current_spending_usd · number · required

Current spending in current billing cycle (USD)

Example:

234.5

monthly_spending_budget · integer | null

Soft spending limit in USD cents (null = unlimited)

Example:

10000

monthly_spending_budget_usd · number | null

Soft spending limit in USD

Example:

100

spending_alert_thresholds · integer[]

Percentage thresholds for spending alerts

Example:

[50, 75, 90, 100]

spending_alerts_enabled · boolean · default: true

Whether spending alerts are enabled

spending_alerts_sent · integer[]

Alert thresholds triggered in current billing cycle

Example:

[50, 75]

hard_spending_cap · integer | null

Hard spending limit in USD cents (null = no hard cap)

Example:

50000

hard_spending_cap_usd · number | null

Hard spending limit in USD

Example:

500

hard_cap_enabled · boolean · default: false

Whether hard spending cap is enforced

budget_percentage_used · number | null

Percentage of budget used (null if no budget set)

Example:

46.9