---
title: "Get Order Appointment Availability"
method: POST
path: "/v3/order/phlebotomy/appointment/availability"
tags: ["order"]
---

# Get Order Appointment Availability

`POST /v3/order/phlebotomy/appointment/availability`

Return the available time slots to book an appointment with a phlebotomist
for the given address and order.

## Query parameters

- `start_date` string, date, nullable — Start date for appointment availability

## Request body

- USAddress
  - `first_line` string, required
  - `second_line` string, nullable
  - `city` string, required
  - `state` string, required
  - `zip_code` string, required
  - `unit` string, nullable — Deprecated. Use `second_line` instead to provide the unit number. Subject to removal after 20 Nov 2023.
  - `access_notes` string, nullable

## Response `200`

Successful Response

- AppointmentAvailabilitySlots
  - `slots` DaySlots[], required
    - `location` AppointmentLocation
      - `location` LngLat, required
        - `lng` number, required
        - `lat` number, required
      - `distance` integer, nullable
      - `address` USAddress, required
        - `first_line` string, required
        - `second_line` string, nullable
        - `city` string, required
        - `state` string, required
        - `zip_code` string, required
        - `unit` string, nullable — Deprecated. Use `second_line` instead to provide the unit number. Subject to removal after 20 Nov 2023.
        - `access_notes` string, nullable
      - `code` string, required
      - `name` string, required
      - `iana_timezone` string, nullable
    - `date` string, date, required
    - `slots` TimeSlot[], required
      - `booking_key` string, nullable
      - `start` string, date-time, required — Time is in UTC
      - `end` string, date-time, required — Time is in UTC
      - `expires_at` string, date-time, nullable
      - `price` number, required
      - `is_priority` boolean, required
      - `num_appointments_available` integer, required
  - `timezone` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tryvital/apis/junction-api.md) · [All operations](https://skmtc.net/tryvital/apis/junction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryvital/junction-api/revisions/034402e2bbe3/schema)