---
title: "View a teammate"
method: GET
path: "/settings/users/{user_id}"
tags: ["Users"]
---

# View a teammate

`GET /settings/users/{user_id}`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/settings/users/{user_id}`
- Auth: HTTP bearer

View a teammate.

## Path parameters

- `user_id` string, required

## Response `200`

Success.

- UserResponse
  - `data` User, required: A teammate (agent, admin, or owner) on the organization.
    - `id` string
    - `name` string
    - `first_name` string
    - `last_name` string
    - `email` string, email
    - `phone` string, nullable
    - `job_title` string, nullable
    - `avatar` string, uri, nullable
    - `role` 'Account Owner' | 'Administrator' | 'User'
    - `presence` 'online' | 'away' | 'null', nullable
    - `timezone` string, nullable
    - `time_format` string, nullable: 12h or 24h.
    - `active_organization_id` string, nullable
    - `created_at` string, date-time
    - `extra` object: Per-user preferences.
      - `password_reset_required` boolean
      - `notification_preferences` object
      - `firebase_notification_preferences` object
      - `mobile_notification_preferences` object
      - `auto_advance_ticket_enabled` boolean
      - `undo_send_enabled` boolean
      - `undo_send_delay` integer, nullable

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Token is valid but does not include a required scope, or the user does not have access to the resource.
- `404`: Resource not found.
- `422`: Request body failed validation.
- `429`: Rate limit exceeded. The `Retry-After` header indicates how long to wait before retrying. See [Pagination and rate limits](/get-started/pagination) for the full rate-limit policy.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api.md) - [All operations](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api/revisions/dce9c632a018?raw)
