Calendars
Get all calendars
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 / OOO
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence
- POSTAutomatically reassign booking to a new host
- POSTReassign a booking to a specific user
- POSTConfirm booking that requires a confirmation
- POSTDecline booking that requires a confirmation
- GETGet 'Add to Calendar' links for a booking
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
OAuth Clients
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Timezones
Calendars
Get all calendars
GET
/
v2
/
calendars
curl --request GET \
--url https://api.cal.com/v2/calendars
{
"status": "success",
"data": {
"connectedCalendars": [
{
"integration": {
"appData": {},
"dirName": "<string>",
"__template": "<string>",
"name": "<string>",
"description": "<string>",
"installed": true,
"type": "<string>",
"title": "<string>",
"variant": "<string>",
"category": "<string>",
"categories": [
"<string>"
],
"logo": "<string>",
"publisher": "<string>",
"slug": "<string>",
"url": "<string>",
"email": "<string>",
"locationOption": {}
},
"credentialId": 123,
"delegationCredentialId": "<string>",
"primary": {
"externalId": "<string>",
"integration": "<string>",
"name": "<string>",
"primary": true,
"readOnly": true,
"email": "<string>",
"isSelected": true,
"credentialId": 123,
"delegationCredentialId": "<string>"
},
"calendars": [
{
"externalId": "<string>",
"integration": "<string>",
"name": "<string>",
"primary": true,
"readOnly": true,
"email": "<string>",
"isSelected": true,
"credentialId": 123,
"delegationCredentialId": "<string>"
}
]
}
],
"destinationCalendar": {
"id": {},
"integration": "<string>",
"externalId": "<string>",
"primaryEmail": "<string>",
"userId": 123,
"eventTypeId": 123,
"credentialId": 123,
"delegationCredentialId": "<string>",
"name": "<string>",
"primary": true,
"readOnly": true,
"email": "<string>",
"integrationTitle": "<string>"
}
}
}
Response
200 - application/json
Available options:
success
, error
Example:
"success"
Was this page helpful?
curl --request GET \
--url https://api.cal.com/v2/calendars
{
"status": "success",
"data": {
"connectedCalendars": [
{
"integration": {
"appData": {},
"dirName": "<string>",
"__template": "<string>",
"name": "<string>",
"description": "<string>",
"installed": true,
"type": "<string>",
"title": "<string>",
"variant": "<string>",
"category": "<string>",
"categories": [
"<string>"
],
"logo": "<string>",
"publisher": "<string>",
"slug": "<string>",
"url": "<string>",
"email": "<string>",
"locationOption": {}
},
"credentialId": 123,
"delegationCredentialId": "<string>",
"primary": {
"externalId": "<string>",
"integration": "<string>",
"name": "<string>",
"primary": true,
"readOnly": true,
"email": "<string>",
"isSelected": true,
"credentialId": 123,
"delegationCredentialId": "<string>"
},
"calendars": [
{
"externalId": "<string>",
"integration": "<string>",
"name": "<string>",
"primary": true,
"readOnly": true,
"email": "<string>",
"isSelected": true,
"credentialId": 123,
"delegationCredentialId": "<string>"
}
]
}
],
"destinationCalendar": {
"id": {},
"integration": "<string>",
"externalId": "<string>",
"primaryEmail": "<string>",
"userId": 123,
"eventTypeId": 123,
"credentialId": 123,
"delegationCredentialId": "<string>",
"name": "<string>",
"primary": true,
"readOnly": true,
"email": "<string>",
"integrationTitle": "<string>"
}
}
}