> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getagentdrive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account Usage

> Retrieve current usage metrics for your account. Works for both claimed and unclaimed (provisioned) drive keys.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.getagentdrive.com/v0/account/usage \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "storage": {
      "used": 524288000,
      "limit": 5368709120
    },
    "operations": {
      "used": 1500,
      "limit": 100000
    },
    "bandwidth": {
      "used": 1073741824,
      "limit": 10737418240
    },
    "period": {
      "start": "2026-03-01T00:00:00Z",
      "end": "2026-03-31T23:59:59Z"
    }
  }
  ```
</ResponseExample>

## Response

<ResponseField name="storage" type="object">
  Storage usage for the account.

  <Expandable title="properties">
    <ResponseField name="used" type="integer">
      Bytes of storage currently used.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum bytes of storage allowed by the plan.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="operations" type="object">
  API operation usage for the current billing period.

  <Expandable title="properties">
    <ResponseField name="used" type="integer">
      Number of operations used in the current period.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum operations allowed per period.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="bandwidth" type="object">
  Bandwidth usage for the current billing period.

  <Expandable title="properties">
    <ResponseField name="used" type="integer">
      Bytes of bandwidth used in the current period.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum bytes of bandwidth allowed per period.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="period" type="object">
  The current billing period.

  <Expandable title="properties">
    <ResponseField name="start" type="string">
      ISO 8601 timestamp of the period start.
    </ResponseField>

    <ResponseField name="end" type="string">
      ISO 8601 timestamp of the period end.
    </ResponseField>
  </Expandable>
</ResponseField>