Skip to main content
GET
/
v4
/
booking-availability
Get booking availability for a meeting type
curl --request GET \
  --url https://api.example.com/v4/booking-availability
{
  "timezone": "<string>",
  "timeframes": [
    {
      "start": "<string>",
      "end": "<string>",
      "unavailabilityEvent": {
        "hostId": "<string>",
        "hostName": "<string>",
        "type": "event",
        "picture": "<string>"
      }
    }
  ],
  "dates": [
    {
      "date": "<string>",
      "spots": [
        {
          "startTime": "<string>",
          "unavailabilityEvents": [],
          "appointment": {
            "id": "<string>",
            "totalSpots": 123,
            "takenSpots": 123
          }
        }
      ]
    }
  ],
  "earliestAvailableDate": "<string>",
  "earliestMonthAvailability": "<unknown>"
}

Documentation Index

Fetch the complete documentation index at: https://developer.meetergo.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

meetingTypeId
string
required
meetingDuration
number
start
string
required
end
string
required
hostIds
string[]
queueId
string

Queue ID of meeting type for hosts in round robin

existingAppointmentId
string

Appointment ID of previous booking for rescheduling

calculationMethod
enum<string>
Available options:
everyone,
anyone
timezone
string
hideGroupAppointments
boolean
skipEarliestBookingCalculation
boolean
troubleshoot
boolean
default:false

Get blocked timeslots with available slots for diagnostics

refreshCache
boolean

Force cache refresh (skip read, write result). Used after slot-occupied error to fetch fresh availability.

resourceChannelIds
string[]

Ids of the resource channel entity

channel
enum<string>

Selected channel for per-channel availability lookup Meeting channel/location type

Available options:
local,
local-attendee,
google,
zoom,
phone,
phone-incoming,
whatsapp,
connect,
webex,
skypeForConsumer,
skypeForBusiness,
teamsForBusiness,
teamsForBusiness2,
teamsForExchange,
teams2ForExchange,
custom,
resource,
whereby,
kmeet,
zava,
jitsi
attendeeEmail
string

Booker email used for account-owner matching on round-robin meeting types. When matching is enabled and an owner resolves to one of the meeting type's eligible hosts, availability is narrowed to that host. Ignored when the meeting type does not have account-owner matching enabled.

Response

timezone
string
required
timeframes
object[]
required
dates
object[]
required
earliestAvailableDate
string
earliestMonthAvailability
any

Full availability data for the month containing earliestAvailableDate