How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Vital order API

The order API from Vital — 32 operation(s) for order.

Vital order API is one of 18 APIs that Vital publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 7 JSON Schema definitions.

Tagged areas include Order. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 7 JSON Schemas.

This API exposes 33 operations across 32 paths, and defines 112 schemas. It is described by OpenAPI 3.1.0, at version 0.4.497.

Requests are made against 4 base URLs: https://api.us.junction.com, https://api.eu.junction.com, https://api.sandbox.us.junction.com, https://api.sandbox.eu.junction.com.

33 operations 32 paths 112 schemas 15 GET6 PATCH12 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.4.497
Base URL
https://api.us.junction.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Vital order API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-vital-api-key (apiKeyAuth). By default, every request must be authenticated.

  • apiKeyAuth — Vital Team API Key

Paths & Operations 33

Across 32 paths, the API surfaces 33 operations — 15 GET, 6 PATCH, 12 POST. Each is listed below with its method, path, parameters, and response codes.

order 33
POST
/v3/order/testkit/register
Register Testkit
register_testkit_v3_order_testkit_register_post body → 200422
POST
/v3/order/testkit
Create Testkit Order
create_testkit_order_v3_order_testkit_post body → 200422
POST
/v3/order/phlebotomy/appointment/availability
Get Order Appointment Availability
get_order_appointment_availability_v3_order_phlebotomy_appointment_availability_post 1 param body → 200422
POST
/v3/order/{order_id}/phlebotomy/appointment/book
Book Phlebotomy Appointment
book_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_book_post 1 param body → 200422
POST
/v3/order/{order_id}/phlebotomy/appointment/request
Request Phlebotomy Appointment
request_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_request_post 1 param body → 200422
PATCH
/v3/order/{order_id}/phlebotomy/appointment/reschedule
Reschedule Phlebotomy Appointment
reschedule_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_reschedule_patch 1 param body → 200422
PATCH
/v3/order/{order_id}/phlebotomy/appointment/cancel
Cancel Phlebotomy Appointment
cancel_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_cancel_patch 1 param body → 200422
GET
/v3/order/phlebotomy/appointment/cancellation-reasons
Get Phlebotomy Appointment Cancellation Reasons
get_phlebotomy_appointment_cancellation_reasons_v3_order_phlebotomy_appointment_cancellation_reasons_get → 200
GET
/v3/order/{order_id}/phlebotomy/appointment
Get Phlebotomy Appointment
get_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_get 1 param → 200422
GET
/v3/order/area/info
Get Area Info
get_area_info_v3_order_area_info_get 5 params → 200422
GET
/v3/order/psc/info
Get Psc Info
get_psc_info_v3_order_psc_info_get 5 params → 200422
GET
/v3/order/{order_id}/psc/info
Get Order Psc Info
get_order_psc_info_v3_order__order_id__psc_info_get 3 params → 200422
GET
/v3/order/{order_id}/result/pdf
Get Lab Test Result
get_lab_test_result_v3_order__order_id__result_pdf_get 1 param → 200422
GET
/v3/order/{order_id}/result/metadata
Get Lab Test Result Metadata
get_lab_test_result_metadata_v3_order__order_id__result_metadata_get 1 param → 200422
GET
/v3/order/{order_id}/result
Get Lab Test Result Raw
get_lab_test_result_raw_v3_order__order_id__result_get 1 param → 200422
GET
/v3/order/{order_id}/labels/pdf
Get Order Labels
get_order_labels_v3_order__order_id__labels_pdf_get 3 params → 200422
POST
/v3/order/psc/appointment/availability
Get Psc Appointment Availability
get_psc_appointment_availability_v3_order_psc_appointment_availability_post 6 params → 200404422
POST
/v3/order/{order_id}/psc/appointment/book
Book Phlebotomy Appointment
book_phlebotomy_appointment_v3_order__order_id__psc_appointment_book_post 3 params body → 200422
PATCH
/v3/order/{order_id}/psc/appointment/reschedule
Reschedule Phlebotomy Appointment
reschedule_phlebotomy_appointment_v3_order__order_id__psc_appointment_reschedule_patch 1 param body → 200422
PATCH
/v3/order/{order_id}/psc/appointment/cancel
Cancel Phlebotomy Appointment
cancel_phlebotomy_appointment_v3_order__order_id__psc_appointment_cancel_patch 1 param body → 200422
GET
/v3/order/psc/appointment/cancellation-reasons
Get Phlebotomy Appointment Cancellation Reasons
get_phlebotomy_appointment_cancellation_reasons_v3_order_psc_appointment_cancellation_reasons_get → 200
GET
/v3/order/{order_id}/psc/appointment
Get Phlebotomy Appointment
get_phlebotomy_appointment_v3_order__order_id__psc_appointment_get 1 param → 200422
POST
/v3/order/resend_events
Resend Order Webhook
resend_order_webhook_v3_order_resend_events_post body → 200422
GET
/v3/order/{order_id}/collection_instruction_pdf
Get Order Collection Instructions Url
get_order_collection_instructions_url_v3_order__order_id__collection_instruction_pdf_get 1 param → 200422
GET
/v3/order/{order_id}/requisition/pdf
Get Order Requisition Url
get_order_requisition_url_v3_order__order_id__requisition_pdf_get 1 param → 200422
GET
/v3/order/{order_id}/abn_pdf
Get Order Abn
get_order_abn_v3_order__order_id__abn_pdf_get 1 param → 200422
GET
/v3/order/{order_id}
Get Order
get_order_v3_order__order_id__get 1 param → 200422
PATCH
/v3/order/{order_id}
Update Order
update_order_v3_order__order_id__patch 1 param body → 200422
POST
/v3/order
Create Order
create_order_v3_order_post 2 params body → 200422
POST
/v3/order/import
Import Order
import_order_v3_order_import_post body → 200422
POST
/v3/order/{order_id}/cancel
Cancel Order
cancel_order_v3_order__order_id__cancel_post 1 param → 200422
POST
/v3/order/{order_id}/test
Order Process Simulate
order_process_simulate_v3_order__order_id__test_post 3 params body → 200422
PATCH
/v3/order/{order_id}/draw_completed
Update On Site Collection Order Draw Completed
update_on_site_collection_order_draw_completed_v3_order__order_id__draw_completed_patch 1 param → 200422

Schemas 112

The contract defines 112 schemas that model the data the API accepts and returns. The most detailed are ClientFacingOrder (31 properties), BiomarkerResult (20 properties), ClientFacingAppointment (19 properties), CreateOrderRequestCompatible (18 properties). Each schema is shown below with its type and property counts.

OrderOrigin
string
ℹ️ This enum is non-exhaustive.
GuarantorDetails
object
7 properties 4 required
FailureType
string
ℹ️ This enum is non-exhaustive.
ClientFacingWalkInOrderDetails
object
2 properties 1 required
ConsentType
string
ℹ️ This enum is non-exhaustive.
ClientFacingLabs
string
ℹ️ This enum is non-exhaustive.
MarkerType
string
ℹ️ This enum is non-exhaustive.
PatientAddressCompatible
object
9 properties 5 required
ClientFacingOrderTransaction
object
Order transaction info.
3 properties 3 required
Billing
string
ℹ️ This enum is non-exhaustive.
AllowedRadius
string
ℹ️ This enum is non-exhaustive.
api__api_v1__endpoints__vital_api__lab_testing__orders__helpers__AppointmentCancelRequest
object
2 properties 1 required
OrderStatus
string
Used in combination with OrderStatusDetail to represent the current order state. OrderStatus is driven by a FSM whereas OrderStatusDetail is descriptive only.…
ClientFacingOrderEvent
object
4 properties 3 required
Ethnicity
string
ℹ️ This enum is non-exhaustive.
ClientFacingWalkInTestOrder
object
Schema for a walk-in test order in the client facing API. To be used as part of a ClientFacingOrder.
4 properties 3 required
ClientFacingOrder
object
31 properties 17 required
LngLat
object
2 properties 2 required
OrderStatusDetail
string
A descriptive-only additional field to be used in combination with OrderStatus. Exposed in the API. ℹ️ This enum is non-exhaustive.
PostOrderResponse
object
3 properties 3 required
ClientFacingMarker
object
14 properties 3 required
USAddress
object
7 properties 4 required
AppointmentProvider
string
ℹ️ This enum is non-exhaustive.
MissingBiomarkerResult
object
8 properties 3 required
ResponsibleRelationship
string
ℹ️ This enum is non-exhaustive.
QuestionType
string
ℹ️ This enum is non-exhaustive.
PatientAddressWithValidation
object
9 properties 5 required
ClientFacingAppointment
object
19 properties 14 required
ClientFacingAppointmentCancellationReason
object
3 properties 3 required
SimulationFlags
object
3 properties
ResendWebhookBody
object
3 properties
SampleData
object
7 properties
ClientFacingOrderInTransaction
object
Minimal order info for embedding in ordertransaction payload.
7 properties 3 required
ClinicalInformation
object
4 properties
PSCInfo
object
3 properties 3 required
LabResultsMetadata
object
14 properties 5 required
OrderLowLevelStatus
string
ℹ️ This enum is non-exhaustive.
ClientFacingPatientDetailsCompatible
object
11 properties 2 required
Race
string
ℹ️ This enum is non-exhaustive.
ClientFacingPhysician
object
3 properties 3 required
HealthInsuranceCreateRequest
object
10 properties
HTTPValidationError
object
1 property
AppointmentEventStatus
string
ℹ️ This enum is non-exhaustive.
OrderTopLevelStatus
string
ℹ️ This enum is non-exhaustive.
ClientFacingLabTest
object
16 properties 10 required
CreateRegistrableTestkitOrderRequest
object
5 properties 3 required
TimeSlot
object
7 properties 5 required
PatientAddress
object
8 properties 6 required
AoEAnswer
object
3 properties 3 required
AoE
object
1 property 1 required
DaySlots
object
3 properties 2 required
LabTestSampleType
string
The type of sample used to perform a lab test. ℹ️ This enum is non-exhaustive.
AppointmentLocation
object
6 properties 4 required
ClientFacingLabLocation
object
6 properties 6 required
AddOnOrder
object
2 properties
AppointmentStatus
string
ℹ️ This enum is non-exhaustive.
AppointmentRescheduleRequest
object
2 properties 1 required
Interpretation
string
ℹ️ This enum is non-exhaustive.
ClientFacingAtHomePhlebotomyOrderDetails
object
2 properties 1 required
Question
object
9 properties 7 required
UpdateOrderBody
object
Patch body for updating a modifiable order's scheduled activation date.
1 property 1 required
Gender
string
ℹ️ This enum is non-exhaustive.
Address
object
7 properties 5 required
Labs
string
ℹ️ This enum is non-exhaustive.
ShippingAddress
object
8 properties 7 required
UTCTimestampWithTimezoneOffset
object
2 properties 2 required
SexualOrientation
string
ℹ️ This enum is non-exhaustive.
Consent
object
3 properties 1 required
PSCAreaInfo
object
3 properties 3 required
LabLocationMetadata
object
9 properties 5 required
RequestAppointmentRequest
object
3 properties 2 required
ClientFacingOnSiteCollectionOrderDetails
object
2 properties 1 required
AppointmentBookingRequest
object
5 properties 1 required
CreateOrderRequestCompatible
object
Schema for the create Order endpoint.
18 properties 3 required
ClientFacingAppointmentEvent
object
3 properties 2 required
GenderIdentity
string
ℹ️ This enum is non-exhaustive.
Jpeg
object
2 properties 2 required
ImportOrderBody
object
9 properties 7 required
AppointmentServiceType
string
ℹ️ This enum is non-exhaustive.
ClientFacingShipment
object
Schema for a Shipment in the client facing API. To be used as part of a ClientFacingTestkitOrder.
8 properties 8 required
PSCAreaInfoDetails
object
4 properties 3 required
LabTestCollectionMethod
string
The method used to perform a lab test. ℹ️ This enum is non-exhaustive.
PhysicianCreateRequestBase
object
5 properties 3 required
PerformingLaboratory
object
4 properties 1 required
Answer
object
3 properties 3 required
ClientFacingTestKitOrderDetails
object
2 properties 1 required
AppointmentType
string
ℹ️ This enum is non-exhaustive.
ParentBiomarkerData
object
4 properties 3 required
ClientFacingAtHomePhlebotomyOrder
object
Schema for a at-home-phlebotomy test order in the client facing API. To be used as part of a ClientFacingOrder.
4 properties 3 required
LabResultsRaw
object
5 properties 2 required
BiomarkerResult
object
Represent the schema for an individual biomarker result.
20 properties 3 required
ClientFacingOnSiteCollectionOrder
object
Schema for an on-site collection order in the client facing API. To be used as part of a ClientFacingOrder.
3 properties 3 required
PatientDetailsWithValidation
object
Patient details with validation for firstname, lastname, email, and dob.
13 properties 6 required
LabTestStatus
string
ℹ️ This enum is non-exhaustive.
ResendWebhookResponse
object
1 property 1 required
PhlebotomyProviderInfo
object
2 properties 2 required
vital_core__clients__lab_test__getlabs__schema__AppointmentCancelRequest
object
2 properties 1 required
PhysicianCreateRequest
object
6 properties 3 required
AppointmentAvailabilitySlots
object
2 properties 1 required
ClientFacingLab
object
8 properties 8 required
vital_core__schemas__db_schemas__lab_test__health_insurance__PersonDetails
object
5 properties 4 required
AreaInfo
object
3 properties 3 required
LabLocationCapability
string
ℹ️ This enum is non-exhaustive.
RegisterTestkitRequest
object
7 properties 3 required
Png
object
2 properties 2 required
ResultType
string
ℹ️ This enum is non-exhaustive.
ShippingAddressWithValidation
object
8 properties 7 required
OrderSetRequest
object
3 properties
PhlebotomyAreaInfo
object
2 properties 2 required
ClientFacingTestkitOrder
object
Schema for a testkit order in the client facing API. To be used as part of a ClientFacingOrder.
4 properties 4 required
AppointmentPSCLabs
string
ℹ️ This enum is non-exhaustive.
OrderTransactionStatus
string
ℹ️ This enum is non-exhaustive.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vital-io-order-api-openapi.yml Raw ↑

Other APIs Vital publishes across the network.

Vital Management API
Vital Aggregate API
Vital compendium API
Vital insurance API
Vital introspect API
Vital lab_account API
Vital lab_report API
Vital lab_tests API
Vital link API
Vital order_transaction API
Vital orders API
Vital payor API
Where this information came from

This is an independent, third-party profile of Vital order API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.