---
title: "Cancel Phlebotomy Appointment"
method: PATCH
path: "/v3/order/{order_id}/psc/appointment/cancel"
tags: ["order"]
---

# Cancel Phlebotomy Appointment

`PATCH /v3/order/{order_id}/psc/appointment/cancel`

## Path parameters

- `order_id` string, uuid, required — Your Order ID.

## Request body

- VitalCoreClientsLabTestGetlabsSchemaAppointmentCancelRequest
  - `cancellationReasonId` string, uuid4, required
  - `note` string, nullable

## Response `200`

Successful Response

- ClientFacingAppointment
  - `id` string, uuid4, required
  - `user_id` string, uuid4, required
  - `order_id` string, uuid4, required
  - `order_transaction_id` string, uuid4, 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
  - `location` LngLat, required
    - `lng` number, required
    - `lat` number, required
  - `start_at` string, date-time, nullable, required — Time is in UTC
  - `end_at` string, date-time, nullable, required — Time is in UTC
  - `iana_timezone` string, nullable
  - `type` 'phlebotomy' | 'patient_service_center', required — ℹ️ This enum is non-exhaustive.
  - `provider` 'getlabs' | 'phlebfinders' | 'quest' | 'sonora_quest', required — ℹ️ This enum is non-exhaustive.
  - `status` 'confirmed' | 'pending' | 'reserved' | 'in_progress' | 'completed' | 'cancelled', required — ℹ️ This enum is non-exhaustive.
  - `provider_id` string, required
  - `external_id` string, nullable
  - `can_reschedule` boolean, required
  - `appointment_notes` string, nullable
  - `event_status` 'pending' | 'reserved' | 'scheduled' | 'completed' | 'cancelled' | 'in_progress', required — ℹ️ This enum is non-exhaustive.
  - `event_data` object, nullable
  - `events` ClientFacingAppointmentEvent[], required
    - `created_at` string, date-time, required
    - `status` 'pending' | 'reserved' | 'scheduled' | 'completed' | 'cancelled' | 'in_progress', required — ℹ️ This enum is non-exhaustive.
    - `data` object, nullable

## Other responses

- `422` — Validation Error

---

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