# Retrieve account usage

`GET https://api.cademi.com.br/api/v3/account/usage`

Operation ID: `account.usage` · API v3

Returns aggregated API usage for the account over the time window selected by `period`, including request and operation totals, a breakdown by credential, and rate limit information.

Requires the `usage.read` permission.

Required permissions: `usage.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `period` | query | string, one of `1h`, `24h`, `7d`, `30d` | yes |  |

## Responses

### 200

Returns the aggregated usage for the requested period.

Body: `data`: Usage.

Fields of Usage:

| Field | Type | Required | Description |
|---|---|---|---|
| `by_credential` | array of object | yes |  |
| `ingestion_delay_seconds` | integer | yes |  |
| `object` | string, one of `usage` | yes |  |
| `operations` | object | yes |  |
| `rate_limits` | object or null | yes |  |
| `requests` | object | yes |  |
| `window` | object | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json