Skip to main content
GET
/
v2
/
oauth-clients
/
{clientId}
/
users
Get all managed users
curl --request GET \
  --url https://api.cal.com/v2/oauth-clients/{clientId}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'x-cal-secret-key: <x-cal-secret-key>'
{
  "status": "success",
  "data": [
    {
      "id": 1,
      "email": "alice+cluo37fwd0001khkzqqynkpj3@example.com",
      "username": "alice",
      "name": "alice",
      "bio": "bio",
      "timeZone": "America/New_York",
      "weekStart": "Sunday",
      "createdDate": "2024-04-01T00:00:00.000Z",
      "timeFormat": 12,
      "defaultScheduleId": null,
      "locale": "en",
      "avatarUrl": "https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png",
      "metadata": {
        "key": "value"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-cal-secret-key
string
required

OAuth client secret key

Path Parameters

​
clientId
string
required

Query Parameters

​
limit
number

The number of items to return

Example:

10

​
offset
number

The number of items to skip

Example:

0

​
emails
string[]

Filter managed users by email. If you want to filter by multiple emails, separate them with a comma.

Example:

"?emails=email1@example.com,email2@example.com"

Response

200 - application/json
​
status
enum<string>
required
Available options:
success,
error
Example:

"success"

​
data
object[]
required