Get Booking Availability

Returns available time slots for booking a meeting with a specific meeting type and optional host selection.

Endpoint

GET /v4/booking-availability

Request Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <your-api-key>`

This endpoint does not require the x-meetergo-api-user-id header as it queries availability for a meeting type.

Query Parameters

Parameter	Type	Required	Description
`meetingTypeId`	string	Yes	The ID of the meeting type to check availability for
`start`	string	Yes	Start date in `YYYY-MM-DD` format
`end`	string	Yes	End date in `YYYY-MM-DD` format
`hostIds`	string	No	Comma-separated host user IDs. For round-robin meeting types, pass all host IDs from the queue
`queueId`	string	No	Queue ID for round-robin meeting types
`calculationMethod`	string	No	`anyone` (default) or `everyone`. With `anyone`, a slot is available if any host is free. With `everyone`, all hosts must be free simultaneously
`meetingDuration`	number	No	Duration in minutes (for meeting types with multiple duration options)
`timezone`	string	No	Timezone for returned slots (e.g., `Europe/Berlin`)
`channel`	string	No	Meeting channel (e.g., `local`, `zoom`, `phone`). Uses channel-specific availability if configured
`existingAppointmentId`	string	No	Appointment ID when rescheduling (ignores its blocked time)
`resourceChannelIds`	string[]	No	Filter by specific resource channels (e.g., meeting rooms)
`troubleshoot`	boolean	No	When `true`, returns diagnostic information about blocked slots

For round-robin / queue meeting types, always pass hostIds with the team member IDs. Without hostIds, the API uses the queue’s distribution logic which may return availability for only one host.

Examples

curl -X GET "https://api.meetergo.com/v4/booking-availability?meetingTypeId=abc123&start=2024-01-15&end=2024-01-20&timezone=Europe/Berlin&hostIds=user1,user2,user3&queueId=queue123" \
  -H "Authorization: Bearer YOUR_API_KEY"

const params = new URLSearchParams({
  meetingTypeId: 'abc123',
  start: '2024-01-15',
  end: '2024-01-20',
  timezone: 'Europe/Berlin',
  hostIds: 'user1,user2,user3',
  queueId: 'queue123'
});

const response = await fetch(
  `https://api.meetergo.com/v4/booking-availability?${params}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const availability = await response.json();

import requests

response = requests.get(
    'https://api.meetergo.com/v4/booking-availability',
    params={
        'meetingTypeId': 'abc123',
        'start': '2024-01-15',
        'end': '2024-01-20',
        'timezone': 'Europe/Berlin',
        'hostIds': 'user1,user2,user3',
        'queueId': 'queue123'
    },
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

availability = response.json()

Response

Success (200 OK)

{
  "timezone": "Europe/Berlin",
  "timeframes": [
    {
      "start": "2024-01-15T08:00:00.000Z",
      "end": "2024-01-15T16:00:00.000Z"
    },
    {
      "start": "2024-01-16T08:00:00.000Z",
      "end": "2024-01-16T16:00:00.000Z"
    }
  ],
  "dates": [
    {
      "date": "2024-01-15",
      "spots": [
        { "startTime": "2024-01-15T09:00:00.000+01:00" },
        { "startTime": "2024-01-15T09:30:00.000+01:00" },
        { "startTime": "2024-01-15T10:00:00.000+01:00" },
        { "startTime": "2024-01-15T14:00:00.000+01:00" },
        { "startTime": "2024-01-15T14:30:00.000+01:00" }
      ]
    },
    {
      "date": "2024-01-16",
      "spots": [
        { "startTime": "2024-01-16T09:00:00.000+01:00" },
        { "startTime": "2024-01-16T11:00:00.000+01:00" },
        { "startTime": "2024-01-16T15:00:00.000+01:00" }
      ]
    }
  ],
  "earliestAvailableDate": "2024-01-15"
}

Field	Description
`timezone`	The timezone used for the response
`timeframes`	Array of available time windows (UTC)
`timeframes[].start`	Start of the available window in ISO 8601 (UTC)
`timeframes[].end`	End of the available window in ISO 8601 (UTC)
`dates`	Array of available dates with bookable spots
`dates[].date`	The date in `YYYY-MM-DD` format
`dates[].spots`	Array of bookable time slots for the date
`dates[].spots[].startTime`	Start time in ISO 8601 with timezone offset
`earliestAvailableDate`	The earliest date with available spots (`YYYY-MM-DD`)

Error Responses

400 Bad Request - Meeting Type Not Found

{
  "statusCode": 400,
  "message": "Meeting type not found",
  "error": "Bad Request"
}

401 Unauthorized

{
  "statusCode": 401,
  "message": "Invalid API key",
  "error": "Unauthorized"
}

Notes

The response respects the meeting type’s buffer times, minimum booking notice, and maximum advance booking settings
For round-robin meeting types, pass hostIds with all team members and queueId to get the combined availability of the team
When hostIds is provided, only those specific hosts’ availability is considered
Connected calendar events (Google Calendar, Outlook, etc.) automatically block the corresponding time slots

Don’t know your meeting type ID? Go to my.meetergo.com/meeting-types, click on a meeting type, and copy the ID from the URL.

Availability Concepts

Learn about availability schedules and configuration

Create Booking

Book a time slot

availability

availability-exception

Meeting Type V4

Booking Availability V4

Queue V4

Queue User Group V4

Meeting Type Template V4

One Time Booking Link V4

Provisional Booking V4

Handoff V4

Booking Link V4

Booking V4

Attendee V4

Appointment V4

Attendee Pending V4

Personal Page V4

User V4

Calendar Auth V4

Calendar Connections V4

Get Booking Availability

Endpoint

Request Headers

Query Parameters

Examples

Response

Success (200 OK)

Error Responses

400 Bad Request - Meeting Type Not Found

401 Unauthorized

Notes

Availability Concepts

Create Booking

​Endpoint

​Request Headers

​Query Parameters

​Examples

​Response

​Success (200 OK)

​Error Responses

​400 Bad Request - Meeting Type Not Found

​401 Unauthorized

​Notes

​Related Endpoints

Availability Concepts

Create Booking

Endpoint

Request Headers

Query Parameters

Examples

Response

Success (200 OK)

Error Responses

400 Bad Request - Meeting Type Not Found

401 Unauthorized

Notes

Related Endpoints