# Retrieve a User Profile

> Returns a creator's public profile with lifetime totals and page counts.

`GET /users/{username}` on `https://api.mediux.io`

Carries the public profile fields, Avatar and Backdrop as `{id, extension}`, the creator's lifetime Download and View totals (refreshed once a day) and the item count and page count for each kind of content. Hidden, banned, system and content-less Users and unknown usernames (including one given up in a rename) return `404`. Responses are stored but revalidated with the `ETag`.

## Parameters

- `username` (path, string, required): The User's username in lower case (the URL key `lower(username)`), as in `/account` or any embedded `owner`. A spelling with capitals answers `308 Permanent Redirect` to the lower-case path. Usernames can change: after a rename the old username is not found at once, so keep the stable `id` and re-read the username from the creators directory.

## Responses

### 200

The User Profile.

- `data` (object, required)
  - `kind` (string, required): One of "user".
  - `id` (string (uuid), required)
  - `username` (string, required)
  - `bio` (string, nullable, required)
  - `links` (array of object, required)
    - `platform` (string, required): One of "bluesky", "discord", "github", "instagram", "letterboxd", "mastodon", "reddit", "simkl", "trakt".
    - `handle` (string, required)
    - `url` (string (uri), nullable, required)
  - `downloadCount` (integer, required)
  - `viewCount` (integer, required)
  - `totalsUpdatedAt` (string, nullable, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
  - `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`.
  - `backdrop` (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`.
  - `content` (object, required)
    - `sets` (object, required)
      - `totalItems` (integer, required)
      - `totalPages` (integer, required)
    - `boxsets` (object, required)
      - `totalItems` (integer, required)
      - `totalPages` (integer, required)
    - `loadouts` (object, required)
      - `totalItems` (integer, required)
      - `totalPages` (integer, required)
    - `assets` (object, required)
      - `totalItems` (integer, required)
      - `totalPages` (integer, required)
    - `lists` (object, required)
      - `totalItems` (integer, required)
      - `totalPages` (integer, required)

### 304

Not modified. The `If-None-Match` validator still matches; no body.

### 400

The path is not a valid route, or the request carried a query string or body.

### 404

The resource does not exist or is not public.

### 405

Only `GET`, `HEAD` and `OPTIONS` are supported.

### 429

Too many cache misses from this address. Retry after the `Retry-After` delay.

### 503

Temporarily unavailable. Retry after the `Retry-After` delay.

## Example response (200)

```json
{
  "data": {
    "kind": "user",
    "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
    "username": "Koltom",
    "bio": null,
    "links": [],
    "downloadCount": 58512,
    "viewCount": 273093,
    "totalsUpdatedAt": "2026-11-18T23:59:59.999Z",
    "avatar": {
      "id": "dee6cbd8-d1c1-4e3d-9f35-e55bd72ac4f4",
      "extension": "png"
    },
    "backdrop": {
      "id": "c8f43af6-83eb-4e3a-b17f-08886e0b0527",
      "extension": "jpg"
    },
    "content": {
      "sets": {
        "totalItems": 105,
        "totalPages": 3
      },
      "boxsets": {
        "totalItems": 8,
        "totalPages": 1
      },
      "loadouts": {
        "totalItems": 0,
        "totalPages": 0
      },
      "assets": {
        "totalItems": 7,
        "totalPages": 1
      },
      "lists": {
        "totalItems": 6,
        "totalPages": 1
      }
    }
  }
}
```
