Skip to main content
GET
Get user by id

Endpoint

Route: /users/{userId}
Authentication: Bearer JWT

Path parameters

Returns archived members as well (no deleted_at filter on get).

Response

200 — User object directly (not wrapped in data)

Archived state

Errors

Authorizations

Authorization
string
header
required

Bearer JWT with valid account context.

Path Parameters

userId
string
required

User ID (UUID)

Response

User

Account member (user + member_account). Role is the display name string. Archived members include archived timestamp and archived_by.

id
string

User ID (UUID)

email
string
full_name
string | null
first_name
string | null
last_name
string | null
role
string

Role display name (read-only)

external_id
string | null
phone
string | null
office_status
boolean
working_hours
object[]

Working hour ranges. Empty array means available 24/7. Times are interpreted in time_zone.

Example:
out_office_dates
object[]
time_zone
string

IANA time zone

Example:

"America/New_York"

calendars
object

Active calendar configs keyed by provider to email

capacity
object[]
can_receive_notifications
boolean
notification_preferences
string[]
archived

false when active, or ISO timestamp when archived

archived_by
string

Present when archived