---
title: "Get a user by ID"
method: GET
path: "/users/{userId}"
tags: ["users"]
---

# Get a user by ID

`GET /users/{userId}`

Retrieves detailed information about a specific user, including their profile, assigned phone numbers, status (active, archived), and configuration. Use this to inspect a user's setup before making changes or to verify user existence.

**Permission:** `Users Read` required.

**Monitoring impact:**
- **OFF:** Returns data only if `userId` matches **your own** user ID. Requesting another user's ID returns `404`.
- **ON:** Returns data for **any user** in the team.

## Path parameters

- `userId` integer, required

## Response `200`

Successful operation

- UserFull
  - `user_id` integer — The user identifier
  - `team_id` integer — The team identifier of the user
  - `initial` string — The initials of the user
  - `color` string
  - `firstname` string — The firstname of the user
  - `lastname` string — The lastname of the user
  - `company` string — The company of the user
  - `email` string — The email of the user
  - `picture` string — The picture of the user
  - `concat_name` string
  - `numbers` Number[] — The numbers of the user
    - `number` integer — Phone number in E.164 format without the `+` prefix (e.g., `33612345678`).
    - `label` string — The label of the number
    - `type` string — The type of the number
    - `user_id` integer — The user identifier
    - `ivr_id` integer — The unique identifier of the IVR. Use `GET /ivrs` to discover available IVR IDs.
    - `conference_id` integer — The conference identifier
    - `is_sms` boolean
    - `is_sms_write` boolean
    - `is_callable` boolean
    - `format` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean
  - `plan` object — The licence plan assigned to the user
    - `id` integer — The plan identifier
    - `name` string — The commercial name of the plan
    - `type` string — The category of the plan
  - `plantype` string — The category of the plan, mirrors `plan.type`

## Other responses

- `400` — The provided user ID is invalid
- `401` — Authentication token is missing, invalid, expired, or Users Read permission is missing
- `404` — No user found with the specified ID (or you do not have access to this user without monitoring)
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)