---
title: "Schedule an appointment for an order"
method: POST
path: "/v1/orders/{orderId}/schedule-appointment"
tags: ["Orders"]
---

# Schedule an appointment for an order

`POST /v1/orders/{orderId}/schedule-appointment`

Schedule an appointment or walk-in for an existing order. Sends HL7 SIU^S12 message for appointment booking.

## Path parameters

- `orderId` string, required

## Request body

- object
  - `appointment` union, required
    - object
      - `type` 'appointment', required
      - `dateTime` string, date-time, required — Required for appointment type
      - `date` string, required — Required for appointment type
      - `time` string, required — Required for appointment type
      - `notes` string — Optional for walkin type
    - object
      - `type` 'walkin', required
      - `dateTime` string, date-time — Required for appointment type
      - `date` string — Required for appointment type
      - `time` string — Required for appointment type
      - `notes` string — Optional for walkin type
  - `orderAccessCode` string, required — Order access code for authorization
  - `providerId` string — Provider ID for authorization

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `message` string, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `404` — Default Response
- `500` — Default Response

---

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