> For the complete documentation index, see [llms.txt](https://docs.castmagic.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.castmagic.io/endpoints/usage.md).

# 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.

{% hint style="info" %}
**Tier:** `platform`. Base URL `https://app.castmagic.io`.
{% endhint %}

## Fetch usage

<mark style="color:blue;">`GET`</mark> `https://app.castmagic.io/v1/usage`

{% tabs %}
{% tab title="200: OK" %}

```json
{
    "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
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Storage figures come from a periodically refreshed snapshot and can be up to \~15 minutes stale.
{% endhint %}