Usage

Read your plan status, usage, and storage for the current period.

Current-period consumption for the caller's account: plan status, API tier, usage, and storage.

Tier: platform. Base URL https://app.castmagic.io.

Fetch usage

GET https://app.castmagic.io/v1/usage

200: OK

{
    "plan_status": "active",
    "api_tier": "platform",
    "usage": {
        "unit": "minute",
        "used": 1240,
        "limit": 6000,
        "unlimited": false,
        "cumulative": false,
        "percentage": 20.7,
        "period_start": "2026-08-01T00:00:00Z",
        "period_end": "2026-09-01T00:00:00Z"
    },
    "storage": {
        "used_bytes": 4831838208,
        "soft_limit_bytes": 10737418240,
        "hard_limit_bytes": 21474836480,
        "unlimited": false,
        "percentage": 45.0
    }
}

Storage figures come from a periodically refreshed snapshot and can be up to ~15 minutes stale.