# Get the connected User

> Returns the User your app is connected to and the scopes your token holds.

`GET /account` on `https://api.mediux.io`

Any access token holding at least one App Permission can call this route. It returns the User ID, the username (the key of their public profile), the avatar as `{id, extension}` or `null`, and the scopes the token carries: no email address, display name or other private data. There are no `openid` or `profile` scopes.

## Authorization

OAuth 2 bearer token in the `Authorization` header. Required permission: any App Permission.

## Responses

### 200

The connected User.

- `data` (object, required)
  - `kind` (string, required): One of "user".
  - `id` (string (uuid), required)
  - `username` (string, required)
  - `avatar` (object, nullable, required)
    - `id` (string (uuid), required): Stable image ID, a lowercase UUID. Variant filenames use the same ID.
    - `extension` (string, required): Extension of the Original, such as `png`.
  - `scopes` (array of string, required)

### 401

The access token is missing (`auth.required`), or invalid, expired or revoked (`auth.invalidToken`).

### 403

The token lacks the required App Permission (`auth.insufficientScope`, with `details.required`), or the account or connection may not do this (`auth.forbidden`).

### 429

Too many requests. Wait the `Retry-After` seconds before trying again.

### 503

Temporarily unavailable. Check the outcome before retrying a write.

## Example response (200)

```json
{
  "data": {
    "kind": "user",
    "id": "b6c53317-87e3-4f0a-ab9b-bc3c272d4f06",
    "username": "ApiSamples",
    "avatar": null,
    "scopes": [
      "lists:read",
      "lists:write",
      "notifications:read",
      "relationships:manage"
    ]
  }
}
```
