BerryBox Read verified daily usage snapshots
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
Query Parameters
Inclusive UTC day.
^20[0-9]{2}-[0-9]{2}-[0-9]{2}$dateExclusive UTC day; at most tomorrow. Range must contain 1–366 days.
^20[0-9]{2}-[0-9]{2}-[0-9]{2}$date"all"Value in
- "all"
- "sandbox"
- "ci"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/management/v1/usage?from=2019-08-24&to=2019-08-24"{ "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "viewerAccountId": "8df1f23a-1fae-4f64-8023-a7ba4e81abbd", "role": "owner", "currency": "USD", "observedAt": "2019-08-24T14:15:22Z", "source": "postgres_daily_snapshots", "producerCompleteness": "unverified", "range": { "from": "2019-08-24", "to": "2019-08-24", "product": "all", "timezone": "UTC", "resolution": "day" }, "coverage": { "available": 0, "missing": 0, "inProgress": 0 }, "days": [ { "day": "2019-08-24", "state": "available", "snapshotAt": "2019-08-24T14:15:22Z", "refreshPending": true, "totals": { "amountMicros": "string", "byProduct": { "sandbox": "string", "ci": "string" }, "quantities": [] } } ], "summary": { "amountMicros": "string", "byProduct": { "sandbox": "string", "ci": "string" }, "quantities": [] }, "breakdown": []}{ "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 }}{ "ok": false, "type": "management.error", "status": 0, "code": "string", "message": "string", "requestId": "string", "error": { "code": "string", "message": "string", "status": 0, "details": null }}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.
List curated accounting activity 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.