> Calendly developer docs. For page Markdown, append .md to any URL.
> Index: https://developer.calendly.com/llms.txt
> API catalog: https://developer.calendly.com/.well-known/api-catalog
> OpenAPI: https://developer.calendly.com/openapi/calendly-api.yaml
> OAuth authorization server: https://calendly.com/.well-known/oauth-authorization-server
> MCP protected resource: https://mcp.calendly.com/.well-known/oauth-protected-resource
> Scheduling MCP endpoint: https://mcp.calendly.com
> Docs search MCP: https://developer.calendly.com/_mcp/server

# View Availability Data

**Event Type Availability**

Calendly users can retrieve information about availability for a specific event type when they generate and use a [personal access token or OAuth token](/docs/authentication/when-to-choose-between-personal-access-tokens-and-oauth) to authenticate requests to Calendly's API.

Use cases that can be achieved with this API:

* Take appropriate action based on available times for a given event type.
* Effectively share available meeting times from an external application to increase the probability of meetings being booked and enhance the invitee experience.
  * For example:
    * Display specific available times when sending communications to invitees directly from external applications.
    * Include and share first 'X' available times.

**To retrieve a list of available times for a specific event type within a specified date range**:

1. Make a call to [/event\_types](/api-docs/calendly-api/event-types/list-event-types) to retrieve a list of all event types (using the organization scope to get all event types across the organization or using the user scope to get all event types for a specific user). The endpoint will return a collection of event types with an event type uri for each item in the array.

2. Make a call to [/event\_type\_available\_times](/api-docs/calendly-api/event-types/list-event-type-available-times) and pass the event type uri for the event type you would like to retrieve information about. Please note that start\_time and end\_time parameters are required, must be in the future, and cannot span more than 31 days.

**User Calendar Availability**

Calendly users can retrieve information about the availability of users in their organization when they generate and use a [personal access token or OAuth token](/docs/authentication/when-to-choose-between-personal-access-tokens-and-oauth) to authenticate requests to Calendly's API.

Use cases that can be achieved with this API:

* Programmatically calculate total hours available for a given user for a given period of time. For example:
  * Total available hours
  * Total scheduled hours
* Build a custom 'Calendar View' for a given user.
* View availability schedules and date overrides to determine if a user needs to open up more availability options.

To retrieve information about a specific user's availability schedule and their busy times for a given period, make the following GET requests:

**To retrieve the availability schedules and date overrides for a specific user:**

1. Make a call to [/organization\_memberships](/api-docs/calendly-api/organizations/list-organization-memberships) to return a collection of users in an organization which includes a user.uri for each item in the array.

2. Make a call to [/user\_availability\_schedules](/api-docs/calendly-api/availability/list-user-availability-schedules) and pass the specified user.uri .

**To retrieve busy times for a specific user (based upon the connected calendars marked as "Check for Conflicts" in Calendly):**

1. Make a call to [/organization\_memberships](/api-docs/calendly-api/organizations/list-organization-memberships) to return a collection of users in an organization which includes a user.uri for each item in the array.

2. Make a call to [/user\_busy\_times](/api-docs/calendly-api/availability/list-user-busy-times) and pass the specified user.uri . Please note that start\_time and end\_time parameters are required, must be in the future, and cannot be a range greater than 7 days.