Management APIRecorded finance

Read recorded limits and runtime availability

Requires explicit billing:read and the key creator’s current owner, admin or billing role. Team and account come only from the stored key binding. The exact key generation/scope and membership are checked again in one read-only repeatable snapshot. No caller-supplied team override is supported. Read work has an 8-second transport deadline after the independent key/rate guards. Missing or current-day usage remains unavailable; producer completeness is unverified. No provider IDs, raw usage attributes or private ledger metadata are returned.

Endpoint playground

Targets https://berrybox.io. Hosted availability is pending. Use a disposable key; this form keeps credentials only until you leave this endpoint or select Clear.

Requires explicit billing:read and the key creator’s current owner, admin or billing role. Team and account come only from the stored key binding. The exact key generation/scope and membership are checked again in one read-only repeatable snapshot. No caller-supplied team override is supported. Read work has an 8-second transport deadline after the independent key/rate guards. Missing or current-day usage remains unavailable; producer completeness is unverified. No provider IDs, raw usage attributes or private ledger metadata are returned.

Authorization

ManagementKey
AuthorizationBearer <token>

A team-bound management key with the endpoint's required scope. Dashboard cookies, sandbox keys, and OIDC tokens are not accepted.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/management/v1/limits"
{  "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",  "viewerAccountId": "8df1f23a-1fae-4f64-8023-a7ba4e81abbd",  "role": "owner",  "currency": "USD",  "observedAt": "2019-08-24T14:15:22Z",  "operational": {    "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",    "sandbox": {      "availability": "unavailable",      "concurrency": null    },    "ci": {      "availability": "unavailable",      "concurrency": null    },    "budget": {      "reached": true    },    "payment": {      "failed": true    },    "abuse": {      "held": true    }  },  "financial": {    "state": "available",    "ledgerNetMicros": "string",    "usedThisPeriodMicros": "string",    "budgetMicros": "string",    "budgetReached": true,    "periodStart": "2019-08-24T14:15:22Z",    "periodEnd": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  },  "budgetEnforcement": "admission_with_runtime_holds",  "alerts": "recorded_usage",  "increaseRequests": "unavailable"}