order

Cancel Phlebotomy Appointment

patch/v3/order/{order_id}/psc/appointment/cancel

Path parameters

order_idstring uuid required

Your Order ID.

Your Order ID.

Request body

cancellationReasonIdstring uuid4 required
notestring nullable

Response

Successful Response

idstring uuid4 required
user_idstring uuid4 required
order_idstring uuid4 required
order_transaction_idstring uuid4 nullable
start_atstring date-time nullable required

Time is in UTC

end_atstring date-time nullable required

Time is in UTC

iana_timezonestring 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_idstring required
external_idstring nullable
can_rescheduleboolean required
appointment_notesstring nullable
event_status'pending' | 'reserved' | 'scheduled' | 'completed' | 'cancelled' | 'in_progress' required

ℹ️ This enum is non-exhaustive.

event_dataobject nullable

Example response

{
  "address": {
    "access_notes": "Gate code #1234, use side entrance",
    "city": "San Francisco",
    "country": "United States",
    "first_line": "123 Main St.",
    "second_line": "Apt. 208",
    "state": "CA",
    "zip_code": "91189"
  },
  "appointment_notes": "Please bring photo ID",
  "can_reschedule": true,
  "end_at": "2022-01-01T00:00:00",
  "event_data": {
    "description": "Metadata field containing provider specific data, like cancellation reason or origin"
  },
  "event_status": "scheduled",
  "events": [
    {
      "created_at": "2022-01-01T00:00:00Z",
      "status": "scheduled"
    },
    {
      "created_at": "2022-01-02T00:00:00Z",
      "status": "completed"
    }
  ],
  "external_id": "ext-123",
  "iana_timezone": "America/New_York",
  "id": "843e4d80-375b-4a93-b399-ebbe3187d6f9",
  "location": {
    "lat": 37.7749295,
    "lng": -122.4194155
  },
  "order_id": "b25f49a6-b8d3-4cb7-8a46-f94f60f2afba",
  "order_transaction_id": "7f30c788-9c97-4dd3-be9b-9288e4b22c1c",
  "provider": "getlabs",
  "provider_id": "123",
  "start_at": "2022-01-01T00:00:00",
  "status": "confirmed",
  "type": "phlebotomy",
  "user_id": "13103dab-538a-4746-8ae4-14f2e04d353f"
}

Changes