# Get appointment availability

Returns available appointment slots for a time range. Time range must not exceed 2 months (62 days).

Endpoint: GET /partner/v2/account/{accountId}/self-scheduling/availability
Version: 2.0
Security: PartnerOAuth

## Query parameters:

  - `selfSchedulingSettingId` (integer, required)
    Self-scheduling setting ID
    Example: 123

  - `startUnix` (integer, required)
    Start time in milliseconds since epoch
    Example: 1704067200000

  - `endUnix` (integer, required)
    End time in milliseconds since epoch
    Example: 1706745600000

  - `locationId` (integer, required)
    Location ID
    Example: 1

  - `appointmentTypeId` (integer, required)
    Appointment type ID
    Example: 10

  - `practitionerIds` (string)
    Comma-separated practitioner IDs to filter (optional)
    Example: "7,8,9"

## Path parameters:

  - `accountId` (integer, required)
    Account identifier

## Response 200 fields (application/json):

  - `arePractitionersSelectable` (boolean)
    If true, the patient can choose their practitioner and each slot includes a practitionerToConfig map. If false, the system auto-assigns the best-ranked practitioner and each slot includes a single practitionerId.
    Example: true

  - `practitioners` (array)
    List of practitioners who have availability in the queried time range

  - `practitioners.displayName` (string)
    Full name of the practitioner (first and last name)
    Example: "Jane Smith"

  - `practitioners.firstAvailableSlot` (integer)
    Earliest available slot start time in milliseconds since epoch. Null if no availability.
    Example: 1704103200000

  - `practitioners.practitionerId` (integer)
    Staff ID of the practitioner. This corresponds to a staff member who is configured as a practitioner based on role groups.
    Example: 42

  - `slotsByDate` (object)
    Available time slots grouped by date. Keys are dates in M/d/yyyy format (e.g. "1/15/2025"). Values are arrays of available slots for that date, sorted by time then practitioner rank. Only dates with available slots are included.

  - `timeZone` (string)
    IANA timezone of the practice location (all slot times are in UTC epoch millis)
    Example: "America/New_York"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields