Junction

Junction Order API

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

GitHub OpenAPI

Operations 36

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v3/order/testkit/register Register a received test kit · Register Testkit #
Ask an LLM
“How does a patient register a test kit they received?”
“Can I register a kit by its sample ID together with patient details?”
Tell an agent
Register test kit {sample_id} for patient {patient_details} at {patient_address}.
Register sample {sample_id} to user {user} with details {patient_details} and address {patient_address}.
POST /v3/order/testkit Order an unregistered test kit · Create Testkit Order #
Ask an LLM
“Can I ship an at-home test kit to a user before it's registered?”
“What do I need to order a test kit for a lab test?”
Tell an agent
Order a test kit for lab test {lab_test} for user {user}, shipping to {shipping}.
Ship a {lab_test} kit to {user} at {shipping}.
POST /v3/order/phlebotomy/appointment/availability Find at-home blood draw time slots · Get Order Appointment Availability #
Ask an LLM
“What at-home blood draw time slots are open near a patient's address?”
“Can I check mobile phlebotomist availability starting from a specific date?”
Tell an agent
Find at-home phlebotomy slots at {first_line}, {city}, {state} {zip}.
Check mobile phlebotomist availability for {first_line}, {zip} from {start_date}.
POST /v3/order/{order_id}/phlebotomy/appointment/book Book an at-home blood draw · Book Phlebotomy Appointment #
Ask an LLM
“How do I book an at-home blood draw for an order?”
“Can I leave notes for the phlebotomist when booking a home visit?”
Tell an agent
Book at-home phlebotomy for order {order_id} using slot {booking_key}.
Book home draw slot {booking_key} for order {order_id} with notes {notes}.
POST /v3/order/{order_id}/phlebotomy/appointment/request Request an at-home blood draw · Request Phlebotomy Appointment #
Ask an LLM
“Can I request an at-home draw without picking a specific time slot?”
“Is there a way to request a home phlebotomy visit through a particular provider?”
Tell an agent
Request an at-home phlebotomy appointment for order {order_id} at {address} via {provider}.
Ask {provider} to schedule a home draw for order {order_id} at {address}.
PATCH /v3/order/{order_id}/phlebotomy/appointment/reschedule Reschedule an at-home blood draw · Reschedule Phlebotomy Appointment #
Ask an LLM
“Can I move a booked at-home blood draw to another time?”
“What do I need to change the slot of a home phlebotomy visit?”
Tell an agent
Reschedule order {order_id}'s home draw to slot {booking_key}.
Move the at-home phlebotomy visit for {order_id} to {booking_key}.
PATCH /v3/order/{order_id}/phlebotomy/appointment/cancel Cancel an at-home blood draw · Cancel Phlebotomy Appointment #
Ask an LLM
“How do I cancel an at-home phlebotomy appointment?”
“Do I need a cancellation reason to call off a home blood draw?”
Tell an agent destructive · confirm first
Cancel the at-home draw for order {order_id} with reason {reason}.
Call off order {order_id}'s home phlebotomy visit, reason {reason}, notes {cancel_notes}.
GET /v3/order/phlebotomy/appointment/cancellation-reasons List reasons for cancelling a home draw · Get Phlebotomy Appointment Cancellation Reasons #
Ask an LLM
“What reasons are accepted for cancelling an at-home blood draw?”
“Where do I get the reason IDs for home phlebotomy cancellations?”
Tell an agent
List cancellation reasons for at-home phlebotomy.
Show the reason codes for cancelling a home draw.
GET /v3/order/{order_id}/phlebotomy/appointment Get an order's at-home draw appointment · Get Phlebotomy Appointment #
Ask an LLM
“When is the at-home blood draw scheduled for an order?”
“Can I see the status of an order's home phlebotomy visit?”
Tell an agent
Get the at-home phlebotomy appointment for order {order_id}.
Show order {order_id}'s home draw booking.
GET /v3/order/area/info Check lab-testing coverage for a zip code · Get Area Info #
Ask an LLM
“Is a zip code covered by the at-home phlebotomy network?”
“Which lab locations serve patients within a radius of a zip code?”
Tell an agent
Check lab-testing coverage for zip {zip_code}.
Get area info for {zip_code} within radius {radius} for lab {lab}.
GET /v3/order/psc/info Find a lab's patient service centers near a zip · Get Psc Info #
Ask an LLM
“Where are a lab's nearest patient service centers for a zip code?”
“Can I filter service centers by their capabilities?”
Tell an agent
Find patient service centers for lab {lab_id} near {zip_code}.
List {lab_id} service centers within {radius} of {zip_code} with capabilities {capabilities}.
GET /v3/order/{order_id}/psc/info Find service centers for an existing order · Get Order Psc Info #
Ask an LLM
“Which patient service centers can a patient visit for an order already placed?”
“Can I widen the search radius for an order's service centers?”
Tell an agent
Find patient service centers for order {order_id}.
List service centers within {radius} for order {order_id}.
GET /v3/order/{order_id}/result/pdf Download an order's results PDF · Get Lab Test Result #
Ask an LLM
“Can I download the lab results PDF for an order?”
“Where's the printable results report for an order?”
Tell an agent
Download the results PDF for order {order_id}.
Get order {order_id}'s lab result report as a PDF.
GET /v3/order/{order_id}/result/metadata Get an order's result metadata · Get Lab Test Result Metadata #
Ask an LLM
“What lab, provider and sample dates are attached to an order's results?”
“Can I get result metadata without the test values?”
Tell an agent
Get result metadata for order {order_id}.
Show the lab and sample dates on order {order_id}'s results.
GET /v3/order/{order_id}/result Get an order's raw result data · Get Lab Test Result Raw #
Ask an LLM
“Can I get an order's lab results as raw JSON data?”
“Is there a machine-readable version of results with metadata included?”
Tell an agent
Get raw JSON results for order {order_id}.
Pull order {order_id}'s test data and metadata as JSON.
GET /v3/order/{order_id}/labels/pdf Print specimen labels for an order · Get Order Labels #
Ask an LLM
“How do I print specimen labels for an order?”
“Can I choose how many labels to print and set the collection date?”
Tell an agent
Print labels for order {order_id} collected on {collection_date}.
Get {number} labels for order {order_id} with collection date {collection_date}.
POST /v3/order/psc/appointment/availability Find service center appointment slots · Get Psc Appointment Availability #
Ask an LLM
“What appointment times are open at a lab's patient service centers?”
“Can I check service center availability by site code or zip code?”
Tell an agent
Find service center appointment slots for lab {lab} near {zip_code}.
Check availability at sites {site_codes} for {lab} from {start_date}.
POST /v3/order/{order_id}/psc/appointment/book Book a patient service center visit · Book Phlebotomy Appointment #
Ask an LLM
“How do I book a patient service center visit for an order?”
“Can I use an idempotency key when booking a service center appointment?”
Tell an agent
Book service center slot {booking_key} for order {order_id}.
Reserve a patient service center appointment for {order_id} using {booking_key}.
PATCH /v3/order/{order_id}/psc/appointment/reschedule Reschedule a patient service center visit · Reschedule Phlebotomy Appointment #
Ask an LLM
“Can I move a patient service center appointment to a different slot?”
“What's needed to rebook a lab site visit for an order?”
Tell an agent
Reschedule order {order_id}'s service center visit to slot {booking_key}.
Rebook the patient service center appointment on {order_id} to {booking_key}.
PATCH /v3/order/{order_id}/psc/appointment/cancel Cancel a patient service center visit · Cancel Phlebotomy Appointment #
Ask an LLM
“How do I cancel a patient service center appointment?”
“Can I leave a note when cancelling a lab site visit?”
Tell an agent destructive · confirm first
Cancel the service center appointment for order {order_id} with reason {psc_reason}.
Cancel {order_id}'s lab site visit, reason {psc_reason}, note {note}.
GET /v3/order/psc/appointment/cancellation-reasons List reasons for cancelling a service center visit · Get Phlebotomy Appointment Cancellation Reasons #
Ask an LLM
“What reasons can I give for cancelling a service center appointment?”
“Where do I find reason IDs for patient service center cancellations?”
Tell an agent
List cancellation reasons for service center appointments.
Show the reason codes for cancelling a lab site visit.
GET /v3/order/{order_id}/psc/appointment Get an order's service center appointment · Get Phlebotomy Appointment #
Ask an LLM
“When is the patient service center appointment for an order?”
“Can I check the booking details of an order's lab site visit?”
Tell an agent
Get the service center appointment for order {order_id}.
Show order {order_id}'s patient service center booking.
POST /v3/order/resend_events Replay order webhooks · Resend Order Webhook #
Ask an LLM
“Can I replay order webhooks I missed?”
“Is it possible to resend order events for a time window?”
Tell an agent
Resend webhooks for orders {order_ids}.
Replay order events from {start_at} to {end_at}.
GET /v3/order/{order_id}/communication_settings Get Order Communication Settings #
PATCH /v3/order/{order_id}/communication_settings Create Or Update Order Communication Settings #
GET /v3/order/{order_id}/tracking Get Order Tracking #
GET /v3/order/{order_id}/collection_instruction_pdf Get an order's collection instructions · Get Order Collection Instructions Url #
Ask an LLM
“Where can I get the collection instructions for a specific order?”
“Does an order come with a sample collection guide PDF?”
Tell an agent
Get the collection instructions PDF for order {order_id}.
Download order {order_id}'s collection guide.
GET /v3/order/{order_id}/requisition/pdf Get an order's requisition form · Get Order Requisition Url #
Ask an LLM
“How do I get the requisition form for an order?”
“Can I download an order's requisition as a PDF?”
Tell an agent
Get the requisition PDF for order {order_id}.
Download order {order_id}'s lab requisition form.
GET /v3/order/{order_id}/abn_pdf Get an order's ABN form · Get Order Abn #
Ask an LLM
“Where do I get the Advance Beneficiary Notice for an order?”
“Is there an ABN PDF for an order?”
Tell an agent
Get the ABN PDF for order {order_id}.
Download the Advance Beneficiary Notice for {order_id}.
GET /v3/order/{order_id} Get a lab order · Get Order #
Ask an LLM
“What's the current status of a lab order?”
“Can I look up one order by its ID?”
Tell an agent
Get order {order_id}.
Show me the details of lab order {order_id}.
PATCH /v3/order/{order_id} Change an order's activation date · Update Order #
Ask an LLM
“Can I change when an order is scheduled to activate?”
“Which order statuses still allow changing the activation date?”
Tell an agent
Set order {order_id} to activate on {activate_by}.
Push back the activation date of {order_id} to {activate_by}.
POST /v3/order Place a lab order for a patient · Create Order #
Ask an LLM
“How do I place a lab order for a patient?”
“Can I attach ICD codes and health insurance when creating an order?”
Tell an agent
Create an order for user {user} for lab test {lab_test} with patient {patient_details} at {patient_address}.
Place a {priority} priority order for {user} with ICD codes {icd_codes}.
POST /v3/order/import Import an order for an existing sample · Import Order #
Ask an LLM
“Can I import an order for a sample that was already collected?”
“What's required to bring an existing sample in as an order?”
Tell an agent
Import an order for sample {sample_id} for user {user}.
Import sample {sample_id} for {user} with order set {order_set}, billed as {billing_type}.
POST /v3/order/{order_id}/cancel Cancel a lab order · Cancel Order #
Ask an LLM
“How do I cancel a lab order?”
“Can an order be cancelled after it's placed?”
Tell an agent destructive · confirm first
Cancel order {order_id}.
Cancel lab order {order_id} now.
POST /v3/order/{order_id}/test Simulate an order's status progression · Order Process Simulate #
Ask an LLM
“Can I simulate an order moving through its statuses for testing?”
“Can I set the final status and delay when simulating an order?”
Tell an agent
Simulate order {order_id} through to status {final_status}.
Simulate processing for {order_id} with a {delay} delay.
PATCH /v3/order/{order_id}/draw_completed Mark an on-site draw as completed · Update On Site Collection Order Draw Completed #
Ask an LLM
“How do I mark an on-site collection order's draw as completed?”
“What updates an on-site order once the blood draw is done?”
Tell an agent
Mark the draw completed for order {order_id}.
Record that on-site collection for {order_id} is done.

Documentation

📖
Documentation
https://docs.junction.com/api-details/junction-api
📖
Documentation
https://docs.junction.com/wearables/providers/introduction
📖
Documentation
https://docs.junction.com/api-details/junction-management-api

Specifications

⚙
OpenAPI
https://artifacts.apis.io/junction-com/openapi/junction-com-order-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-user-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-provider-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-sleep-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-activity-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-heart-rate-timeseries-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-lab-order-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-lab-result-schema.json

Other Resources

🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-create-user-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-link-token-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-sleep-summary-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-heart-rate-timeseries-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-create-order-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-lab-result-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/junction-com:junction-com-order-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

junction-com-order-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Junction Order API
  version: '1.0'
  description: 'Operations tagged order across 2 of this provider''s published API definitions: junction-openapi-live-2026-10-12.json, vital-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.us.junction.com
  x-fern-server-name: Production
- url: https://api.eu.junction.com
  x-fern-server-name: ProductionEU
- url: https://api.sandbox.us.junction.com
  x-fern-server-name: Sandbox
- url: https://api.sandbox.eu.junction.com
  x-fern-server-name: SandboxEU
security:
- apiKeyAuth: []
tags:


# --- truncated at 32 KB (195 KB total) ---
# Full source: https://artifacts.apis.io/junction-com/openapi/junction-com-order-api-openapi.yml