---
title: "Get a user's details"
method: GET
path: "/moderation/chat/user/{userId}"
tags: ["Chat"]
---

# Get a user's details

`GET /moderation/chat/user/{userId}`

## Path parameters

- `userId` string, required

## Query parameters

- `accessToken` string, required

## Response `200`

User information

- ModerationUserDetails
  - `user` UserWithDisabledReason
    - `createdAt` string
    - `disabledAt` string
    - `nameChangedAt` string
    - `id` string
    - `displayName` string
    - `previousNames` string[]
    - `scopes` string[]
    - `authProviders` string[] — Friendly names of the external auth methods this user signed in with (e.g. IndieAuth, Fediverse, or a plugin slug). Absent for anonymous users.
    - `displayColor` integer
    - `isBot` boolean
    - `authenticated` boolean
    - `disabledReason` string — Reason provided when the user was disabled.
  - `connectedClients` ModerationConnectedClient[]
    - `connectedAt` string, date-time
    - `userAgent` string
    - `geo` string
    - `id` integer
    - `messageCount` integer
  - `messages` UserMessage[]
    - `timestamp` string
    - `type` string
    - `id` string
    - `user` User
      - `createdAt` string
      - `disabledAt` string
      - `nameChangedAt` string
      - `id` string
      - `displayName` string
      - `previousNames` string[]
      - `scopes` string[]
      - `authProviders` string[] — Friendly names of the external auth methods this user signed in with (e.g. IndieAuth, Fediverse, or a plugin slug). Absent for anonymous users.
      - `displayColor` integer
      - `isBot` boolean
      - `authenticated` boolean
    - `hiddenAt` string
    - `clientId` integer
    - `body` string

## Other responses

- `401` — Unauthorized
- `404` — Not found
- `default` — Unexpected error

## Changes

- **2026-08-27** `e2ce1f2fcdfa` — 1 breaking, 11 warning, 1 info
  - the `user` response's property type changed from `object` to no type for status `200`
  - removed the optional property `user/authProviders` from the response with the `200` status
  - removed the optional property `user/authenticated` from the response with the `200` status
  - removed the optional property `user/createdAt` from the response with the `200` status
  - …9 more
- **2026-06-23** `558a9fa7f4fb` — 2 info
  - added the optional property `messages/items/allOf[#/components/schemas/UserEvent]/user/authProviders` to the response with the `200` status
  - added the optional property `user/authProviders` to the response with the `200` status
- **2024-11-14** `4c2119f0f338` — 1 info
  - api tag `External` removed
- **2024-07-02** `618b7ae59cc5` — 1 info
  - endpoint added
- **2021-09-23** `02fef72d775b` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/owncast/apis/owncast-apis/changes/moderation/chat/user/:userId/get.md)

---

[API](https://skmtc.dev/owncast/apis/owncast-apis.md) · [All operations](https://skmtc.dev/owncast/apis/owncast-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/owncast/owncast-apis/revisions/e2ce1f2fcdfa/schema)