---
title: "GET /availability"
method: GET
path: "/availability"
tags: ["availability"]
---

# GET /availability

`GET /availability`

## 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/availability`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `userId` string

## Response `200`

- AvailabilityDto[]
  - `id` string, required
  - `name` string, required
  - `schedule` WeeklySchedule, required
    - `monday` DaySchedule, required
      - `enabled` boolean, required
      - `hours` HoursSchedule[], required
        - `start` string, required
        - `end` string, required
    - `tuesday` DaySchedule, required
      - `enabled` boolean, required
      - `hours` HoursSchedule[], required
        - `start` string, required
        - `end` string, required
    - `wednesday` DaySchedule, required
      - `enabled` boolean, required
      - `hours` HoursSchedule[], required
        - `start` string, required
        - `end` string, required
    - `thursday` DaySchedule, required
      - `enabled` boolean, required
      - `hours` HoursSchedule[], required
        - `start` string, required
        - `end` string, required
    - `friday` DaySchedule, required
      - `enabled` boolean, required
      - `hours` HoursSchedule[], required
        - `start` string, required
        - `end` string, required
    - `saturday` DaySchedule, required
      - `enabled` boolean, required
      - `hours` HoursSchedule[], required
        - `start` string, required
        - `end` string, required
    - `sunday` DaySchedule, required
      - `enabled` boolean, required
      - `hours` HoursSchedule[], required
        - `start` string, required
        - `end` string, required
  - `timezone` string, required
  - `availabilityExceptions` AvailabilityExceptionDto[], required
    - `ownerId` string, required
    - `ownerType` 'company' | 'user', required
    - `available` boolean, required
    - `start` string, required
    - `end` string, required
    - `title` string
    - `note` string
    - `createdAt` string, required
    - `deletedAt` string, nullable
    - `id` number, required
  - `isDefault` boolean, required
  - `createdAt` string, required
  - `deletedAt` string
  - `useExplicitAvailability` boolean: When enabled, only calendar events with the specified title will be used as available slots.
  - `explicitAvailabilityEventTitle` string, nullable: The calendar event title to look for when useExplicitAvailability is enabled.
  - `ownerName` string: Owner of the schedule
  - `scheduleSource` object, required: 'manual' or 'outlook'
  - `scheduleSourceEmail` string: Mailbox feeding the schedule; set only where the connection relation is loaded.
  - `scheduleSyncedAt` string, nullable: Last time Outlook was consulted
  - `scheduleSyncError` object, nullable: 'no_working_hours', 'unmapped_timezone', 'reauth_required', 'graph_error' or 'connection_removed'

## 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.
- `429`: Rate limited. Back off and retry.

---

[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)