/api/orgs/{org_id}/budgetsList budgets for a month
Provisioning key only. Every budget (all scopes, recurring ones included) with balances for period. Money is integer nano-USD.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Query parameters
periodstringrequiredMonth to meter,
YYYY-MM.
Responses
200Budgets.
Response
budgetsarray<object>requiredbudgets
budget_idstringrequiredperiodstringrequiredYYYY-MM, or*for recurring.scope_kindenumrequiredapi_key_idstring | nullrequiredidentity_idstring | nullrequiredalias_idstring | nullrequiredpool_idstring | nullrequireddeployment_idstring | nullrequiredlimit_nano_usdintegerrequiredThe cap, integer nano-USD. 0 is a hard zero cap.
reserved_nano_usdintegerrequiredIn flight, integer nano-USD.
settled_nano_usdintegerrequiredSpent this month, integer nano-USD.
remaining_nano_usdintegerrequiredInteger nano-USD.
created_by_kindenumrequiredcreated_by_api_key_idstring | nullrequiredThe authoring key; a key may change only its own rows.
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
403The key is not a provisioning key (inference keys are refused, reads included), or it is a customer-plan key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404Unknown organization, or not the key's own organization.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422Missing or malformed
period.
Request
curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/budgets?period=2026-11 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"budgets": [
{
"budget_id": "b7e1c0d2-5a4f-4c39-8e16-2d9f0a7b3c51",
"period": "*",
"scope_kind": "identity",
"api_key_id": null,
"identity_id": "acme-support",
"alias_id": null,
"pool_id": null,
"deployment_id": null,
"limit_nano_usd": 50000000000,
"reserved_nano_usd": 120000000,
"settled_nano_usd": 18400000000,
"remaining_nano_usd": 31480000000,
"created_by_kind": "api_key",
"created_by_api_key_id": "6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33"
}
]
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/budgets?period=2026-11