---
title: "List all team users"
method: GET
path: "/users"
tags: ["users"]
---

# List all team users

`GET /users`

Retrieves users from your team. Each user object includes the user's profile information, assigned phone numbers, status, and configuration. The total number of users is indicated in the `list_count` field.

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

**Monitoring impact:**
- **OFF:** Returns only **your own user data** as a single-item list. You cannot see other team members.
- **ON:** Returns **all users** in the team with their full details.

## Response `200`

Successful operation

- UserList
  - `list_count` integer — The size of the list
  - `list` 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

- `401` — Authentication token is missing, invalid, expired, or Users Read permission is missing
- `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)