---
title: "Get many user's availability at once"
method: GET
path: "/availability/many"
tags: ["availability"]
---

# Get many user's availability at once

`GET /availability/many`

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

## Query parameters

- `userIds` string[]

## Response `200`

- AvailabilityPerUserDto[]
  - `userId` string, required
  - `items` AvailabilityDto[], required
    - `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)