# Get my usage
URL: https://docs.fluenta.io/en/docs/reference/account/get-my-usage
Operation: `getMyUsage`
Required permission: `read`

`GET /v1/external/me/usage`

What this credential has asked of the API: totals, by route and by day. Only its own requests, in every organization.

Counts the requests this credential made, refusals included, over the last `days` days (30 by default, 90 at most). Days are UTC days: `from`, `to` and each `days[].day` are `YYYY-MM-DD` dates of the server’s clock, not of a plant’s, and `from` counts from its first hour. Figures are kept by the hour and may trail the last seconds. A connected app is counted as one credential across the access tokens it was issued; an API token is counted on its own. Nothing in the query names another credential.

### Authorization

- `apiToken` — Bearer token. An API token created in Configuración › Tokens de API, or a connected app’s access token

Send it as `Authorization: Bearer <your API token>`.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `days` | query | number | no | How many days back the figures reach, counted in UTC days from today: `from` is that day, whole, and `to` is today. Usage is kept 90 days. |

### Responses

| Status | Description |
| --- | --- |
| `200` | `ExternalMyUsageDto` |
| `400` | `days` is not a whole number from 1 to 90: `INVALID_REQUEST`, with the field in `details`. |
| `401` | Missing, malformed, unknown, expired or revoked credential: `INVALID_API_TOKEN`. |
| `403` | The credential lacks the «Permiso» the route names (`INSUFFICIENT_SCOPE`), or the organization’s plan does not include what was asked (`PLAN_LIMIT`): «Conectar con IA» for a connected app, or a report or analytics route whose plan feature a Light organization lacks (a Light of plan version 1 keeps `reports`). |
| `429` | The credential is over its rate limit: `RATE_LIMITED`. Per credential, in fixed windows of 60 seconds: 60 requests in one organization on Light and 120 on Pro; 20 on the heavy reads (the range figures, the whole floor, the month and the pauses); 300 across every organization; 60 on the routes that name no organization. Wait `Retry-After` seconds; a refused request counts against nothing. |

### Example

```bash
curl -X GET 'https://api.fluenta.io/v1/external/me/usage' \
  -H 'Authorization: Bearer <your API token>'
```