Get all users - Cal.com Docs

GET

organizations

{orgId}

users

curl --request GET \
  --url https://api.cal.com/v2/organizations/{orgId}/users

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "username": "john_doe",
      "name": "John Doe",
      "email": "[email protected]",
      "emailVerified": "2022-01-01T00:00:00Z",
      "bio": "I am a software developer",
      "avatarUrl": "https://example.com/avatar.jpg",
      "timeZone": "America/New_York",
      "weekStart": "Monday",
      "appTheme": "light",
      "theme": "default",
      "defaultScheduleId": 1,
      "locale": "en-US",
      "timeFormat": 12,
      "hideBranding": false,
      "brandColor": "#ffffff",
      "darkBrandColor": "#000000",
      "allowDynamicBooking": true,
      "createdDate": "2022-01-01T00:00:00Z",
      "verified": true,
      "invitedTo": 1,
      "profile": {
        "id": 1,
        "organizationId": 1,
        "userId": 1,
        "username": "john_doe"
      }
    }
  ]
}

Path Parameters

orgId

number

required

Query Parameters

take

number

The number of items to return

Required range: 1 <= x <= 1000

skip

number

The number of items to skip

Required range: x >= 0

emails

string[]

The email address or an array of email addresses to filter by

Response

200 - application/json

status

enum<string>

required

Available options:

success,

error

Example:

"success"

data

object[]

required

data.id

number

required

The ID of the user

Example:

1

data.email

string

required

The email of the user

Example:

"[email protected]"

data.timeZone

string

required

The time zone of the user

Example:

"America/New_York"

data.weekStart

string

required

The week start day of the user

Example:

"Monday"

data.hideBranding

boolean

required

Whether to hide branding for the user

Example:

false

data.createdDate

string

required

The date when the user was created

Example:

"2022-01-01T00:00:00Z"

data.profile

object

required

organization user profile, contains user data within the organizaton context

data.username

string | null

The username of the user

Example:

"john_doe"

data.name

string | null

The name of the user

Example:

"John Doe"

data.emailVerified

string | null

The date when the email was verified

Example:

"2022-01-01T00:00:00Z"

data.bio

string | null

The bio of the user

Example:

"I am a software developer"

data.avatarUrl

string | null

The URL of the user's avatar

Example:

"https://example.com/avatar.jpg"

data.appTheme

string | null

The app theme of the user

Example:

"light"

data.theme

string | null

The theme of the user

Example:

"default"

data.defaultScheduleId

number | null

The ID of the default schedule for the user

Example:

1

data.locale

string | null

The locale of the user

Example:

"en-US"

data.timeFormat

number | null

The time format of the user

Example:

12

data.brandColor

string | null

The brand color of the user

Example:

"#ffffff"

data.darkBrandColor

string | null

The dark brand color of the user

Example:

"#000000"

data.allowDynamicBooking

boolean | null

Whether dynamic booking is allowed for the user

Example:

true

data.verified

boolean | null

Whether the user is verified

Example:

true

data.invitedTo

number | null

The ID of the user who invited this user

Example:

1

Was this page helpful?

Suggest edits Raise issue

Get schedules of a team member Create a user

curl --request GET \
  --url https://api.cal.com/v2/organizations/{orgId}/users

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "username": "john_doe",
      "name": "John Doe",
      "email": "[email protected]",
      "emailVerified": "2022-01-01T00:00:00Z",
      "bio": "I am a software developer",
      "avatarUrl": "https://example.com/avatar.jpg",
      "timeZone": "America/New_York",
      "weekStart": "Monday",
      "appTheme": "light",
      "theme": "default",
      "defaultScheduleId": 1,
      "locale": "en-US",
      "timeFormat": 12,
      "hideBranding": false,
      "brandColor": "#ffffff",
      "darkBrandColor": "#000000",
      "allowDynamicBooking": true,
      "createdDate": "2022-01-01T00:00:00Z",
      "verified": true,
      "invitedTo": 1,
      "profile": {
        "id": 1,
        "organizationId": 1,
        "userId": 1,
        "username": "john_doe"
      }
    }
  ]
}

Getting Started

Platform / Cal Provider

Platform / Managed Users

Platform / Webhooks

Orgs / Attributes

Orgs / Attributes / Options

Orgs / Delegation Credentials

Orgs / Event Types

Orgs / Memberships

Orgs / Orgs

Orgs / Schedules

Orgs / Teams

Orgs / Teams / Bookings

Orgs / Teams / Memberships

Orgs / Teams / Routing forms / Responses

Orgs / Teams / Schedules

Orgs / Users

Orgs / Users / OOO

Orgs / Webhooks

Api Keys

Bookings

Calendars

Conferencing

Destination Calendars

Event Types

Event Types / Webhooks

Me

OAuth Clients

Schedules

Selected Calendars

Slots

Stripe

Teams

Teams / Event Types

Teams / Memberships

Timezones

Webhooks

Path Parameters

Query Parameters

Response