GET
/
slots
Get all bookable slots between a datetime range
curl --request GET \
  --url https://api.cal.com/v1/slots
{
  "slots": {
    "2024-04-13": [
      {
        "time": "2024-04-13T11:00:00+04:00"
      },
      {
        "time": "2024-04-13T12:00:00+04:00"
      },
      {
        "time": "2024-04-13T13:00:00+04:00"
      }
    ]
  }
}

Authorizations

​
apiKey
string
query
required

Query Parameters

​
apiKey
string
required

Your API Key

Example:

"cal_live_<unique_identifier>"

​
eventTypeId
number

The event type Id to fetch available slots against

​
startTime
string<date-time>
required

Start time of the slot lookup

​
endTime
string<date-time>
required

End time of the slot lookup

​
timeZone
string

TimeZone for the slot lookup

​
usernameList
string[]

An array of usernames, or team slug in case of a team event [To be used when not using eventTypeId]

​
eventTypeSlug
string

Slug of the event type to fetch available slots against [To be used when not using eventTypeId]

​
orgSlug
string

Slug of the organization that the user belongs to, in case the user belongs to an organization [To be used when not using eventTypeId]

​
isTeamEvent
boolean

True if the event is a team event

Response

200
application/json

OK

The response is of type object.