# GET /v1/whoami

Who am I

Actor behind the current API key or session, with its scopes. Any authenticated actor. Rate limit tier: `read`.

- Required scope: any authenticated key or session
- Rate limit: `read` — 120 requests per 60-second window per API key or web session

## Parameters

No parameters.

## Response

```
{ actor_id: integer | null; actor_type: string; api_key_id: integer | null; scopes: ("publisher:read" | "publisher:write" | "admin:read" | "admin:write" | "infra:read" | "infra:write" | "adv:read" | "adv:write" | "scan:work" | "dsp0:review")[] }
```

## Errors

Rate-limited routes return `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the window ends); a 429 also carries `Retry-After`. The headers may be absent while the limiter is temporarily unavailable (requests are then let through).

| Status | Meaning |
|---|---|
| 401 | Missing, invalid or revoked API key. |
| 403 | The key lacks the required scope, or the operation is not allowed for this actor. |
| 429 | Rate limit exceeded; wait `Retry-After` seconds. |

HTML documentation: https://agimone.com/en/developers/api/#who-am-i
API 2026-10
