<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/mcp/get_usage

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# get_usage

**Get upload usage this period**

Show how many files have been protected this billing period (by channel) and the period dates. Requires the billing:read scope. Read-only.

- Access: read-only
- Calls: `/api/v1/billing/usage`

Takes no arguments.

## Tool contract

```json
{
  "name": "get_usage",
  "title": "Get upload usage this period",
  "description": "Show how many files have been protected this billing period (by channel) and the period dates. Requires the billing:read scope. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/billing/usage",
  "arguments": {}
}
```