---
title: "GET /_twake/v1/user_info/{userId}"
method: GET
path: "/_twake/v1/user_info/{userId}"
tags: ["User Info"]
---

# GET /_twake/v1/user_info/{userId}

`GET /_twake/v1/user_info/{userId}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/docs/_twake/v1/user_info/:userId/get.ts> (a function with typed inputs; its response is checked against the schema)

Get user info

## Path parameters

- `userId` string, required

## Response `200`

User info found

- UserInfo: Representation of a Matrix user enriched with optional data from the local user database and common settings.
  - `uid` string, required: The fully‑qualified Matrix user identifier (e.g. `@johndoe:matrix.org`). **Always present**.
  - `display_name` string, required: Human‑readable name for the user. **Always present**.
  - `avatar_url` string, uri: URL of the user’s avatar (`mxc://` URI). Present only if the Matrix server stores an avatar for the user.
  - `phones` string[]: List of phone numbers associated with the user in the local UserDB. Present only when such associations exist.
  - `emails` string[]: List of e‑mail addresses associated with the user in the local UserDB. Present only when such associations exist.
  - `sn` string: *DEPRECATED* Surname (family name) from the UserDB. Present only when the UserDB contains this attribute.
  - `last_name` string: Given name (first name) from the UserDB. Present only when the UserDB contains this attribute.
  - `givenName` string: *DEPRECATED* Surname (family name) from the UserDB. Present only when the UserDB contains this attribute.
  - `first_name` string: Given name (first name) from the UserDB. Present only when the UserDB contains this attribute.
  - `language` string: Preferred language code (e.g. `en`, `fr`). Present only when common settings are enabled and a value is stored.
  - `timezone` string: IANA time‑zone identifier (e.g. `Europe/Paris`). Present only when common settings are enabled and a value is stored.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: User info not found
- `500`: Internal server error

## Changes

- **2026-07-17** `3428c7bb5a46`: 1 warning
  - removed the optional property `active` from the response with the `200` status
- **2025-12-19** `40d580234e7d`: 1 info
  - added the optional property `active` to the response with the `200` status
- **2025-11-19** `18d2eb9eb1ba`: 1 warning, 3 info
  - removed the optional property `mail` from the response with the `200` status
  - added the optional property `emails` to the response with the `200` status
  - added the optional property `first_name` to the response with the `200` status
  - added the optional property `last_name` to the response with the `200` status
- **2025-09-24** `6d7bacb00089`: 7 info
  - added the optional property `avatar_url` to the response with the `200` status
  - added the optional property `language` to the response with the `200` status
  - added the optional property `mail` to the response with the `200` status
  - added the optional property `phones` to the response with the `200` status
  - …3 more
- **2024-01-09** `c7a6d3a400a7`: 2 breaking, 7 warning
  - the response property `uid` became optional for the status `200`
  - removed the required property `display_name` from the response with the `200` status
  - removed the optional property `avatar_url` from the response with the `200` status
  - removed the optional property `emails` from the response with the `200` status
  - …5 more

[Operation history](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/changes/_twake/v1/user_info/:userId/get.md)

---

[API](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation.md) - [All operations](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/revisions/3428c7bb5a46?raw)