---
title: "Retrieve availability"
method: GET
path: "/scheduler/2027-03-beta/meetings/meeting-links/book/availability-page/{slug}"
tags: ["Basic"]
---

# Retrieve availability

`GET /scheduler/2027-03-beta/meetings/meeting-links/book/availability-page/{slug}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/scheduler/2027-03-beta/meetings/meeting-links/book/availability-page/{slug}`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `scheduler.meetings.meeting-link.read`

Retrieve the availability and busy times for a specific meeting link using its slug. This endpoint provides information about when meetings can be scheduled, taking into account the specified timezone and any month offset. It is useful for determining available time slots for booking meetings.

## Path parameters

- `slug` string, required

## Query parameters

- `timezone` string, required
- `monthOffset` integer

## Response `200`

successful operation

- ExternalLinkAvailabilityAndBusyTimes
  - `allUsersBusyTimes` ExternalUserBusyTimes[], required: An array of objects representing the busy times for all users associated with the meeting link. Each object includes information about the user's offline status and their busy time ranges.
    - `busyTimes` ExternalTimeRange[], required: An array of time ranges during which the user is busy, represented by start and end timestamps.
      - `end` integer, required: The end of the time range, represented as an integer in int64 format.
      - `start` integer, required: The start of the time range, represented as an integer in int64 format.
    - `isOffline` boolean, required: A boolean indicating whether the user is offline.
    - `meetingsUser` ExternalMeetingsUser, required
      - `calendarProvider` 'EXCHANGE' | 'GOOGLE' | 'OFFICE365' | 'UNKNOWN', required: The calendar service provider used by the user. Valid values include 'GOOGLE', 'OFFICE365', 'EXCHANGE', and 'UNKNOWN'.
      - `id` string, required: The unique identifier for the external meetings user.
      - `isSalesStarter` boolean, required: A boolean indicating whether the user is a sales starter.
      - `userId` string, required: The unique identifier for the user within the system.
      - `userProfile` ExternalUserProfile, required
        - `email` string, required: The email address of the user. It is a required string property.
        - `firstName` string: The first name of the user. It is a string.
        - `fullName` string: The full name of the user, combining first and last names. It is a string.
        - `lastName` string: The last name of the user. It is a string.
  - `linkAvailability` ExternalLinkAvailability
    - `hasMore` boolean, required: A boolean indicating whether there are additional meeting slots available beyond the current set.
    - `linkAvailabilityByDuration` object, required: An object mapping meeting durations to their respective availability details. Each key is a duration, and the value is an object containing availability information for that duration.

## Other responses

- `default`: An error occurred.

---

[API](https://skmtc.dev/hubspot/apis/scheduler-meetings.md) - [All operations](https://skmtc.dev/hubspot/apis/scheduler-meetings/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/scheduler-meetings/revisions/6d3443ad681b?raw)