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

​
Endpoint

GET /v4/booking-availability

​
Request Headers

HeaderRequiredDescription
AuthorizationYesBearer <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

ParameterTypeRequiredDescription
meetingTypeIdstringYesThe ID of the meeting type to check availability for
startstringYesStart date in YYYY-MM-DD format
endstringYesEnd date in YYYY-MM-DD format
hostIdsstring[]NoComma-separated list of host IDs to filter availability
queueIdstringNoQueue ID for round-robin meeting types
meetingDurationnumberNoDuration in minutes (for meeting types with multiple options)
timezonestringNoTimezone for returned slots (e.g., Europe/Berlin)
existingAppointmentIdstringNoAppointment ID when rescheduling (ignores its blocked time)
resourceChannelIdsstring[]NoFilter by specific resource channels (e.g., meeting rooms)
troubleshootbooleanNoWhen true, returns diagnostic information

​
Examples

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

​
Response

​
Success (200 OK)

{
  "slots": [
    {
      "date": "2024-01-15",
      "times": [
        "2024-01-15T09:00:00+01:00",
        "2024-01-15T09:30:00+01:00",
        "2024-01-15T10:00:00+01:00",
        "2024-01-15T14:00:00+01:00",
        "2024-01-15T14:30:00+01:00"
      ]
    },
    {
      "date": "2024-01-16",
      "times": [
        "2024-01-16T09:00:00+01:00",
        "2024-01-16T11:00:00+01:00",
        "2024-01-16T15:00:00+01:00"
      ]
    }
  ],
  "timezone": "Europe/Berlin"
}
FieldDescription
slotsArray of available time slots grouped by date
slots[].dateThe date in ISO 8601 format
slots[].timesArray of available start times in ISO 8601 format
timezoneThe timezone used for the response

​
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, the availability represents the combined availability of all hosts in the queue
  • When hostIds is provided, only those specific hosts’ availability is considered
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