# Identify the account and scopes behind this key

`GET /v1/whoami`

**Price:** Free.

**Rate limit:** Counts as 1 request against your per-minute rate limit.

**MCP tool:** `get_identity`, on every [MCP](/mcp) connection.

Requires an API key, sent as `Authorization: Bearer <key>`.

## Request

```bash
curl --request GET \
  --url https://api.weirapp.io/v1/whoami \
  --header "Authorization: Bearer $WEIR_API_KEY"
```

## Response

Authenticated API identity.

### `200`

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data` | object | yes |  |
| `data.accountId` | string (uuid) | yes |  |
| `data.apiKeyId` | string (uuid) | yes |  |
| `data.scopes` | array of string | yes |  |
| `meta` | object | yes |  |
| `meta.requestId` | string | yes |  |

## Errors

| Status | Meaning | What to do |
| --- | --- | --- |
| `401` | Invalid API key. | The key is missing, malformed, revoked, or expired. |
| `429` | Rate limit exceeded. | Rate limited. Retryable: wait for `Retry-After`, then try again. |