Cal.com Orgs / Schedules API
The Orgs / Schedules API from Cal.com — 1 operation(s) for orgs / schedules.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cal-com:cal-com-orgs-schedules-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Cal.com API v2 Orgs / Schedules API
description: ''
version: 1.0.0
contact: {}
servers: []
tags:
- name: Orgs / Schedules
paths:
/v2/organizations/{orgId}/schedules:
get:
description: 'Required membership role: `org admin`. PBAC permission: `availability.readOrgAvailability`. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the `ORG_SCHEDULE_READ` scope is required.'
operationId: OrganizationsSchedulesController_getOrganizationSchedules
parameters:
- name: Authorization
in: header
description: For non-platform customers - value must be `Bearer <token>` where `<token>` is api key prefixed with cal_
required: false
schema:
type: string
- name: x-cal-secret-key
in: header
description: For platform customers - OAuth client secret key
required: false
schema:
type: string
- name: x-cal-client-id
in: header
description: For platform customers - OAuth client ID
required: false
schema:
type: string
- name: orgId
required: true
in: path
schema:
type: number
- name: take
required: false
in: query
description: Maximum number of items to return
schema:
minimum: 1
maximum: 250
default: 250
example: 25
type: number
- name: skip
required: false
in: query
description: Number of items to skip
schema:
minimum: 0
default: 0
example: 0
type: number
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/GetSchedulesOutput_2024_06_11'
summary: Get all schedules
tags:
- Orgs / Schedules
x-oauth-scopes:
- ORG_SCHEDULE_READ
x-platform-plan: ESSENTIALS
components:
schemas:
ScheduleOverrideInput_2024_06_11:
type: object
properties:
date:
type: string
example: '2024-05-20'
startTime:
type: string
example: '12:00'
description: startTime must be a valid time in format HH:MM e.g. 12:00
endTime:
type: string
example: '13:00'
description: endTime must be a valid time in format HH:MM e.g. 13:00
required:
- date
- startTime
- endTime
ScheduleOutput_2024_06_11:
type: object
properties:
id:
type: number
example: 254
ownerId:
type: number
example: 478
name:
type: string
example: Catch up hours
timeZone:
type: string
example: Europe/Rome
availability:
example:
- days:
- Monday
- Tuesday
startTime: '17:00'
endTime: '19:00'
- days:
- Wednesday
- Thursday
startTime: '16:00'
endTime: '20:00'
type: array
items:
$ref: '#/components/schemas/ScheduleAvailabilityInput_2024_06_11'
isDefault:
type: boolean
example: true
overrides:
example:
- date: '2024-05-20'
startTime: '18:00'
endTime: '21:00'
type: array
items:
$ref: '#/components/schemas/ScheduleOverrideInput_2024_06_11'
required:
- id
- ownerId
- name
- timeZone
- availability
- isDefault
- overrides
GetSchedulesOutput_2024_06_11:
type: object
properties:
status:
enum:
- success
- error
type: string
example: success
data:
type: array
items:
$ref: '#/components/schemas/ScheduleOutput_2024_06_11'
required:
- status
- data
ScheduleAvailabilityInput_2024_06_11:
type: object
properties:
days:
type: array
items:
type: string
enum:
- Monday
- Tuesday
- Wednesday
- Thursday
- Friday
- Saturday
- Sunday
example:
- Monday
- Tuesday
description: Array of days when schedule is active.
startTime:
type: string
example: 08:00
description: startTime must be a valid time in format HH:MM e.g. 08:00
endTime:
type: string
example: '15:00'
description: endTime must be a valid time in format HH:MM e.g. 15:00
required:
- days
- startTime
- endTime
x-provenance:
method: harvested
publisher: Cal.com
source: https://cal.com/docs/api-reference/v2/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)