Skip to main content
GET
/
v1
/
organizations
/
billing
/
spending-caps
Get Spending Caps
curl --request GET \
  --url https://api.mixpeek.com/v1/organizations/billing/spending-caps
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer YOUR_API_KEY"

"Bearer YOUR_STRIPE_API_KEY"

Response

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