# Key activity

`GET /api/api-keys/{id}/usage`  (operationId: `apiKeyUsage`, group: API keys)

Calls, errors, a daily series, top endpoints and the last 50 calls for one key. Refused and rate-limited calls are included. The log keeps 30 days.

Part of the full API, which is included in the Scale plan. Any one of these scopes is enough: `settings`, `settings:read`.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | integer | yes | Key id. |
| `range` | query | string | no | Window. One of: `7d`, `30d`. Default 7d. |

**Response 200**: OK (schema `KeyUsage`)

| Field | Type | Description |
| --- | --- | --- |
| `range` | string |  |
| `totals` | object |  |
| `totals.calls` | integer |  |
| `totals.errors` | integer |  |
| `totals.forbidden` | integer |  |
| `totals.serverErrors` | integer |  |
| `daily` | array of object |  |
| `daily[][].date` | string |  |
| `daily[][].calls` | integer |  |
| `daily[][].errors` | integer |  |
| `topEndpoints` | array of object |  |
| `topEndpoints[][].method` | string |  |
| `topEndpoints[][].path` | string |  |
| `topEndpoints[][].calls` | integer |  |
| `topEndpoints[][].errors` | integer |  |
| `recent` | array of object |  |
| `recent[][].id` | integer |  |
| `recent[][].ts` | string (date-time) |  |
| `recent[][].method` | string |  |
| `recent[][].path` | string |  |
| `recent[][].status` | integer |  |
| `recent[][].ip` | string, nullable |  |

Example:

```json
{
  "range": "7d",
  "totals": {
    "calls": 2104,
    "errors": 3,
    "forbidden": 1,
    "serverErrors": 0
  },
  "daily": [
    {
      "date": "2026-10-01",
      "calls": 310,
      "errors": 0
    }
  ],
  "topEndpoints": [
    {
      "method": "GET",
      "path": "/api/reporting/v1/conversations",
      "calls": 1800,
      "errors": 0
    }
  ],
  "recent": [
    {
      "id": 99021,
      "ts": "2026-10-02T09:29:10.000Z",
      "method": "GET",
      "path": "/api/reporting/v1/conversations",
      "status": 200,
      "ip": "203.0.113.7"
    }
  ]
}
```

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json