BerryBox Read recorded billing accounting
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 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/billing"{ "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "viewerAccountId": "8df1f23a-1fae-4f64-8023-a7ba4e81abbd", "role": "owner", "currency": "USD", "observedAt": "2019-08-24T14:15:22Z", "accounting": { "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" }, "storedBillingStatus": "active", "subscription": { "status": "active", "cancelAtPeriodEnd": true, "currentPeriodEnd": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }, "providerSynchronization": "unavailable", "providerActions": "unavailable"}{ "ok": false, "type": "management.error", "status": 0, "code": "string", "message": "string", "requestId": "string", "error": { "code": "string", "message": "string", "status": 0, "details": null }}{ "ok": false, "type": "management.error", "status": 0, "code": "string", "message": "string", "requestId": "string", "error": { "code": "string", "message": "string", "status": 0, "details": null }}{ "ok": false, "type": "management.error", "status": 0, "code": "string", "message": "string", "requestId": "string", "error": { "code": "string", "message": "string", "status": 0, "details": null }}{ "ok": false, "type": "management.error", "status": 0, "code": "string", "message": "string", "requestId": "string", "error": { "code": "string", "message": "string", "status": 0, "details": null }}{ "ok": false, "type": "management.error", "status": 0, "code": "string", "message": "string", "requestId": "string", "error": { "code": "string", "message": "string", "status": 0, "details": null }}{ "ok": false, "type": "management.error", "status": 0, "code": "string", "message": "string", "requestId": "string", "error": { "code": "string", "message": "string", "status": 0, "details": null }}Rotate a management key POST
Requires keys:write and permission to manage this key. The existing secret stops working immediately. The key ID and scopes remain unchanged. Rotation is forbidden when the target key has scopes beyond the caller's current permissions.
Read recorded limits and runtime availability GET
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.