---
title: "Get user availability for a specific timeframe"
method: GET
path: "/v4/booking-availability/user/{id}/timeframe"
tags: ["Booking Availability V4"]
---

# Get user availability for a specific timeframe

`GET /v4/booking-availability/user/{id}/timeframe`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/v4/booking-availability/user/{id}/timeframe`
- Auth: none declared

## Path parameters

- `id` string, required

## Query parameters

- `start` string, required
- `end` string, required
- `meetingTypeId` string

## Response `200`

- UserAvailabilityResponseDto
  - `hostId` string, required
  - `available` Timeframe[], required
    - `start` string, required
    - `end` string, required
    - `unavailabilityEvent` UnavailabilityEvent
      - `hostId` string, required
      - `hostName` string, required
      - `picture` string
      - `type` 'event' | 'block' | 'exception' | 'googleEvent' | 'outlookEvent' | 'exchangeEvent' | 'exchangeTeamsEvent' | 'icloudEvent' | 'caldavEvent' | 'smartWeEvent' | 'icsEvent' | 'salesforceEvent' | 'calendarReadFailed' | 'bufferBefore' | 'bufferAfter' | 'bookingBeforeLimit' | 'bookingAfterLimit' | 'perDayBookingLimit' | 'perWeekBookingLimit' | 'perMonthBookingLimit' | 'perYearBookingLimit' | 'outsideHours' | 'outsideBookingBlock' | 'clusterMeetingNotAdjacent' | 'groupSlotFull', required
      - `title` string
      - `description` string
      - `location` string
      - `online` boolean
      - `meetingLink` string
      - `attendees` UnavailabilityEventAttendee[]
        - `fullname` string
        - `email` string
      - `allDay` boolean
      - `affectedSlotCount` number
      - `takenSpots` number
      - `totalSpots` number
      - `scope` 'slot' | 'day' | 'week' | 'month' | 'meetingType' | 'availability' | 'calendar'
      - `recommendedAction` 'reviewAppointment' | 'reviewConflictCalendars' | 'editAvailability' | 'editBuffers' | 'editBookingWindow' | 'editBookingLimits' | 'editBookingBlocks' | 'editClusterMeeting' | 'reconnectCalendar' | 'editGroupSpots'
      - `settingsRoute` string
      - `priority` number
  - `unavailable` Timeframe[], required
    - `start` string, required
    - `end` string, required
    - `unavailabilityEvent` UnavailabilityEvent
      - `hostId` string, required
      - `hostName` string, required
      - `picture` string
      - `type` 'event' | 'block' | 'exception' | 'googleEvent' | 'outlookEvent' | 'exchangeEvent' | 'exchangeTeamsEvent' | 'icloudEvent' | 'caldavEvent' | 'smartWeEvent' | 'icsEvent' | 'salesforceEvent' | 'calendarReadFailed' | 'bufferBefore' | 'bufferAfter' | 'bookingBeforeLimit' | 'bookingAfterLimit' | 'perDayBookingLimit' | 'perWeekBookingLimit' | 'perMonthBookingLimit' | 'perYearBookingLimit' | 'outsideHours' | 'outsideBookingBlock' | 'clusterMeetingNotAdjacent' | 'groupSlotFull', required
      - `title` string
      - `description` string
      - `location` string
      - `online` boolean
      - `meetingLink` string
      - `attendees` UnavailabilityEventAttendee[]
        - `fullname` string
        - `email` string
      - `allDay` boolean
      - `affectedSlotCount` number
      - `takenSpots` number
      - `totalSpots` number
      - `scope` 'slot' | 'day' | 'week' | 'month' | 'meetingType' | 'availability' | 'calendar'
      - `recommendedAction` 'reviewAppointment' | 'reviewConflictCalendars' | 'editAvailability' | 'editBuffers' | 'editBookingWindow' | 'editBookingLimits' | 'editBookingBlocks' | 'editClusterMeeting' | 'reconnectCalendar' | 'editGroupSpots'
      - `settingsRoute` string
      - `priority` number

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `404`: No such resource in your account. Resources belonging to another account are reported the same way.
- `429`: Rate limited. Back off and retry.
- `default`

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)