# Junction: Lab Testing ## Lab Testing ### Product Guides #### Getting Started - [Introduction](https://docs.junction.com/lab/overview/introduction.md): Introduction to the Junction Lab Testing API for ordering lab tests, managing results, and integrating with physician networks and partner labs. - [Testing Modalities](https://docs.junction.com/lab/overview/testing-modalities.md): Compare where and how samples are collected for at-home test kits, mobile phlebotomy, walk-in tests, and on-site collection. - [Order Status and Lifecycle](https://docs.junction.com/lab/workflow/lab-test-lifecycle.md): Understand the namespaced status system for lab test orders with high-level and modality-specific low-level status transitions. - [Orders and Results](https://docs.junction.com/lab/overview/orders-and-results.md): Plan an end-to-end lab testing integration, from configuring and creating orders through monitoring progress and retrieving results. - [Lab Accounts](https://docs.junction.com/lab/overview/lab-accounts.md): Manage lab accounts that link your team to partner laboratories for order routing and result delivery configuration. - [Quickstart](https://docs.junction.com/lab/overview/quickstart.md): Create a patient, select a lab test, and place your first lab order in the Junction sandbox. - [Testing in Sandbox](https://docs.junction.com/lab/overview/sandbox.md): Test lab test ordering in the Junction sandbox environment with lifecycle simulation, pre-configured tests, and collection method restrictions. #### Ordering Workflows - [Ask on Order Entry (AOE)](https://docs.junction.com/lab/workflow/aoe.md): Handle Ask on Order Entry (AOE) questions required for certain biomarkers, including the four question types and API integration. - [Cancelling an Order](https://docs.junction.com/lab/workflow/cancelling-an-order.md): Cancel lab test orders based on their current status and collection method, with guidance on timing to avoid unnecessary costs. - [Choosing Tests and Markers](https://docs.junction.com/lab/workflow/ordering.md): Choose saved lab tests, à la carte markers, or a combination of both when defining what a lab order should include. - [Clinical Notes](https://docs.junction.com/lab/workflow/clinical-comments.md): Add clinical notes to lab orders at the order level or as a Lab Account default for requisition forms. - [Compendium Search](https://docs.junction.com/lab/overview/compendium-search.md): Search the lab test compendium to find canonical tests and crosswalk them to available lab-specific test candidates. - [Creating a Lab Test](https://docs.junction.com/lab/workflow/create-test.md): Create custom lab tests by selecting biomarker IDs and collection methods, then submit them for Junction approval before ordering. - [Importing an Order](https://docs.junction.com/lab/workflow/importing-order.md): Import externally-placed lab orders into Junction for centralized tracking and result delivery using the correct sample or requisition ID. - [Insurance Ordering](https://docs.junction.com/lab/overview/insurance.md): Configure patient insurance and place lab test orders with commercial insurance billing. - [Order and Follow-up Physician](https://docs.junction.com/lab/overview/physicians.md): Choose between using Junction's physician network, your own physicians, or a hybrid approach for lab test ordering and result review. - [Order Requirements](https://docs.junction.com/lab/workflow/order-requirements.md): Review all requirements for placing a lab test order including patient consents, physician options, and patient name validation rules. - [Order Transactions](https://docs.junction.com/lab/workflow/order-transactions.md): Use order transactions to group an initial order with related orders and retrieve their combined results. - [Ordering Idempotency](https://docs.junction.com/lab/overview/idempotency.md): Use the X-Idempotency-Key header when creating lab orders to safely retry requests without duplicating orders on connection failures. - [Patient Communications](https://docs.junction.com/lab/workflow/communications.md): Understand which email and SMS notifications Junction sends for each lab testing modality. - [Scheduled Orders](https://docs.junction.com/lab/workflow/scheduled-orders.md): Schedule lab test orders for future fulfillment dates using the activate_by parameter for follow-up testing workflows. #### Walk-in (Patient Service Center) Orders - [Overview](https://docs.junction.com/lab/walk-in/overview.md): Understand how patients complete walk-in lab orders at a partner laboratory Patient Service Center. - [Find Patient Service Centers](https://docs.junction.com/lab/overview/locations.md): Find supported Patient Service Centers for walk-in collection using the Area Info and PSC Info endpoints. - [Order and Appointment Lifecycle](https://docs.junction.com/lab/walk-in/order-lifecycle.md): Learn the order and appointment statuses, state transitions, and scheduling flows for walk-in lab tests. - [Webhooks](https://docs.junction.com/lab/walk-in/webhooks.md): Reference for webhook events triggered during walk-in order lifecycle changes, with example payload structures. ##### PSC Appointment Scheduling - [Schedule PSC Appointments](https://docs.junction.com/lab/walk-in/psc-appointment-scheduling.md): Find appointment availability and book, retrieve, reschedule, or cancel supported Quest PSC appointments. - [Advanced PSC Scheduling Options](https://docs.junction.com/lab/walk-in/psc-appointment-scheduling-opt-ins.md): Use cached availability, idempotent booking, and asynchronous confirmation for PSC appointments. - [PSC Appointment Errors and Troubleshooting](https://docs.junction.com/lab/walk-in/psc-appointment-errors.md): Handle slot conflicts, invalid requests, order-state errors, and provider failures when scheduling PSC appointments. #### Mobile Phlebotomy Orders - [Overview](https://docs.junction.com/lab/at-home-phlebotomy/overview.md): Understand how a mobile phlebotomist visits a patient to collect a sample for laboratory testing. - [Phlebotomy Service Tiers](https://docs.junction.com/lab/at-home-phlebotomy/service-tiers.md): Compare the two phlebotomy service tiers: Appointment Ready for synchronous scheduling and Appointment Request for asynchronous assignment. - [Order and Appointment Lifecycle](https://docs.junction.com/lab/at-home-phlebotomy/order-appointment-lifecycle.md): Reference for all order and appointment lifecycle statuses in the mobile phlebotomy flow, from order creation through results delivery. - [Webhooks](https://docs.junction.com/lab/at-home-phlebotomy/webhooks.md): Reference for webhook events triggered during mobile phlebotomy order and appointment lifecycle changes, with example payloads. #### At-Home Test Kit Orders - [Overview](https://docs.junction.com/lab/testkits/overview.md): Understand how patients receive, collect, and return an at-home test kit for laboratory processing. - [Order Lifecycle](https://docs.junction.com/lab/testkits/order-lifecycle.md): Reference for all order lifecycle statuses in the at-home test kit flow, including shipping, sample collection, and lab processing stages. - [Test Kit Status Details](https://docs.junction.com/lab/testkits/status-details.md): Reference for test kit order status details, including lab processing blocks and sample errors returned by the API. - [Ordering a Registrable Test Kit](https://docs.junction.com/lab/workflow/order-registrable-testkit.md): Use registrable test kits to ship kits without a bound patient, deferring patient registration until the test kit is activated. - [Proxy Ordering Registrable Test Kits](https://docs.junction.com/lab/workflow/registrable-testkit-proxy-inventory-workflows.md): Recommended proxy-ordering and inventory workflows for registrable test kits. - [Webhooks](https://docs.junction.com/lab/testkits/webhooks.md): Reference for webhook events triggered during at-home test kit order lifecycle changes, with example payload structures. #### On-site Collection Orders - [Overview](https://docs.junction.com/lab/on-site-collection/overview.md): Understand how lab orders are collected at customer-managed locations such as clinics and wellness events. - [Order Lifecycle](https://docs.junction.com/lab/on-site-collection/order-lifecycle.md): Reference for all order lifecycle statuses in the on-site collection flow, from order placement through draw completion and results. - [Webhooks](https://docs.junction.com/lab/on-site-collection/webhooks.md): Reference for webhook events triggered during on-site collection order lifecycle changes, with example payload structures. #### Results and Follow-up - [Results Overview](https://docs.junction.com/lab/results/overview.md): Understand how Junction receives, exposes, and notifies your integration about partial, final, critical, and unmatched lab results. - [Result Formats](https://docs.junction.com/lab/results/result-formats.md): Retrieve lab test results in two formats: raw PDF reports from partner labs and structured JSON data through the Junction API. - [Turnaround Times](https://docs.junction.com/lab/overview/turnaround-times.md): Review turnaround time estimates for lab test results at the marker, panel, and order levels with 95th and 99th percentile metrics. - [Reference Range](https://docs.junction.com/lab/results/reference-range-parsing.md): Parse the reference_range string field in lab results to determine boundary inclusivity and build custom result interpretation logic. - [Partial Result Notifications](https://docs.junction.com/lab/workflow/partials.md): Configure partial result handling to receive webhook notifications when some but not all biomarker results are ready for an order. - [Critical Results](https://docs.junction.com/lab/results/critical-results.md): Understand how Junction categorizes lab result markers as normal, abnormal, or critical, and receive webhook alerts for critical findings. - [Redraws](https://docs.junction.com/lab/workflow/redraws.md): Handle redraw scenarios where patients return for a new blood draw due to missing results. - [Unmatched Lab Results](https://docs.junction.com/lab/workflow/unmatched-results.md): Review lab results that could not be automatically matched to an order, including webhooks, listing, accepting, rejecting, and escalating. - [Follow-ups](https://docs.junction.com/lab/results/follow-up.md): Learn how Junction's physician network handles follow-up communications with patients who receive abnormal lab test results. - [Galleri Multi-Cancer Early Detection Results (GRAIL)](https://docs.junction.com/lab/results/galleri-results.md): Understand the unique result structure for the Galleri multi-cancer early detection test, which returns coded enum values instead of numeric biomarkers. #### Lab Report Parsing - [Lab Report Parsing](https://docs.junction.com/lab/report-parsing/overview.md): Extract structured biomarker data from PDF and image lab reports using the Lab Report Parsing API with automatic LOINC code matching. ### API Reference #### Orders - [Create order](https://docs.junction.com/api-reference/lab-testing/create-order.md): Create or submit order via the Junction API. Requires authentication with your team API key. - [Get orders](https://docs.junction.com/api-reference/lab-testing/get-orders.md): Retrieve orders via the Junction API. Requires authentication with your team API key. - [Get order](https://docs.junction.com/api-reference/lab-testing/get-order.md): Retrieve order via the Junction API. Requires authentication with your team API key. - [Cancel order](https://docs.junction.com/api-reference/lab-testing/cancel-order.md): Cancel an order via the Junction API. Requires authentication with your team API key. - [Get Requisition Form PDF](https://docs.junction.com/api-reference/lab-testing/requisition-pdf.md): Retrieve order requisition pdf via the Junction API. Requires authentication with your team API key. - [Get ABN Form PDF](https://docs.junction.com/api-reference/lab-testing/abn-pdf.md): Retrieve order abn pdf via the Junction API. Requires authentication with your team API key. - [Get Labels PDF](https://docs.junction.com/api-reference/lab-testing/labels-pdf.md): Retrieve order labels pdf via the Junction API. Requires authentication with your team API key. - [Create Unregistered Testkit Order](https://docs.junction.com/api-reference/lab-testing/create-unregistered-order.md): Create or submit order testkit via the Junction API. Requires authentication with your team API key. - [Register Testkit Order](https://docs.junction.com/api-reference/lab-testing/register-order.md): Create or submit order testkit register via the Junction API. Requires authentication with your team API key. - [Update an order](https://docs.junction.com/api-reference/lab-testing/patch-order.md): Update an order via the Junction API. Requires authentication with your team API key. - [Import Order](https://docs.junction.com/api-reference/lab-testing/import-order.md): Create or submit order import via the Junction API. Requires authentication with your team API key. - [Simulate Order](https://docs.junction.com/api-reference/lab-testing/simulate-order.md): Create or submit order test via the Junction API. Requires authentication with your team API key. - [Get Collection Instructions PDF for Order](https://docs.junction.com/api-reference/lab-testing/order-collection-instructions-pdf.md): Retrieve order collection instructions PDF via the Junction API. Requires authentication with your team API key. - [Update Order Draw Completed](https://docs.junction.com/api-reference/lab-testing/update-order-draw-completed.md): Partially update order draw completed via the Junction API. Requires authentication with your team API key. - [Resend order webhooks](https://docs.junction.com/api-reference/lab-testing/resend-order-events.md): Replay the latest webhook event for one or more orders via the Junction API. #### Order Transactions - [Get order transaction](https://docs.junction.com/api-reference/lab-testing/order-transactions/get-order-transaction.md): Retrieve order transaction via the Junction API. Requires authentication with your team API key. #### Lab Accounts - [Get Lab Accounts](https://docs.junction.com/api-reference/lab-testing/lab_accounts.md): Retrieve lab test lab account via the Junction API. Requires authentication with your team API key. #### Physicians - [Get Team Physicians](https://docs.junction.com/api-reference/lab-testing/get-team-physicians.md): Retrieve the list of physicians associated with a team. Requires authentication with your team API key. #### Area Info - [Get area info](https://docs.junction.com/api-reference/lab-testing/area-info.md): Retrieve order area info via the Junction API. Requires authentication with your team API key. - [Get PSC info](https://docs.junction.com/api-reference/lab-testing/psc-info.md): Retrieve order PSC info via the Junction API. Requires authentication with your team API key. - [Get order PSC info](https://docs.junction.com/api-reference/lab-testing/order-psc-info.md): Retrieve order PSC info via the Junction API. Requires authentication with your team API key. #### Mobile Phlebotomy - [Create appointment availability](https://docs.junction.com/api-reference/lab-testing/at-home-phlebotomy/appointment-availability.md): Create or submit order phlebotomy appointment availability via the Junction API. Requires authentication with your team API key. - [Create appointment book](https://docs.junction.com/api-reference/lab-testing/at-home-phlebotomy/appointment-booking.md): Create or submit order phlebotomy appointment book via the Junction API. Requires authentication with your team API key. - [Create appointment request](https://docs.junction.com/api-reference/lab-testing/at-home-phlebotomy/appointment-request.md): Create or submit order phlebotomy appointment request via the Junction API. Requires authentication with your team API key. - [Update appointment reschedule](https://docs.junction.com/api-reference/lab-testing/at-home-phlebotomy/appointment-rescheduling.md): Partially update order phlebotomy appointment reschedule via the Junction API. Requires authentication with your team API key. - [Cancel appointment](https://docs.junction.com/api-reference/lab-testing/at-home-phlebotomy/appointment-cancelling.md): Cancel an order phlebotomy appointment via the Junction API. Requires authentication with your team API key. - [Get appointment cancellation reasons](https://docs.junction.com/api-reference/lab-testing/at-home-phlebotomy/appointment-cancellation-reasons.md): Retrieve order phlebotomy appointment cancellation reasons via the Junction API. Requires authentication with your team API key. - [Get phlebotomy appointment](https://docs.junction.com/api-reference/lab-testing/at-home-phlebotomy/get-appointment.md): Retrieve order phlebotomy appointment via the Junction API. Requires authentication with your team API key. #### Patient Service Center (PSC) - [PSC Appointment Availability](https://docs.junction.com/api-reference/lab-testing/psc-scheduling/appointment-psc-availability.md): Create or submit order PSC appointment availability via the Junction API. Requires authentication with your team API key. - [Book PSC Appointment](https://docs.junction.com/api-reference/lab-testing/psc-scheduling/appointment-psc-booking.md): Create or submit order PSC appointment book via the Junction API. Requires authentication with your team API key. - [Reschedule PSC Appointment](https://docs.junction.com/api-reference/lab-testing/psc-scheduling/appointment-psc-rescheduling.md): Partially update order PSC appointment reschedule via the Junction API. Requires authentication with your team API key. - [Cancel PSC Appointment](https://docs.junction.com/api-reference/lab-testing/psc-scheduling/appointment-psc-cancelling.md): Partially update order PSC appointment cancel via the Junction API. Requires authentication with your team API key. - [PSC Appointment Cancellation Reasons](https://docs.junction.com/api-reference/lab-testing/psc-scheduling/appointment-psc-cancellation-reasons.md): Retrieve order PSC appointment cancellation-reasons via the Junction API. Requires authentication with your team API key. - [Get PSC Appointment](https://docs.junction.com/api-reference/lab-testing/psc-scheduling/get-psc-appointment.md): Retrieve order PSC appointment via the Junction API. Requires authentication with your team API key. #### Tests - [Get Available Tests](https://docs.junction.com/api-reference/lab-testing/tests.md): Retrieve lab tests via the Junction API. Requires authentication with your team API key. - [Get Available Tests](https://docs.junction.com/api-reference/lab-testing/tests-paginated.md): Retrieve lab test via the Junction API. Requires authentication with your team API key. - [Get Lab Test](https://docs.junction.com/api-reference/lab-testing/get-lab-test.md): Retrieve lab tests via the Junction API. Requires authentication with your team API key. - [Get Available Biomarkers](https://docs.junction.com/api-reference/lab-testing/biomarkers.md): Retrieve lab tests markers via the Junction API. Requires authentication with your team API key. - [Get All Available Labs](https://docs.junction.com/api-reference/lab-testing/labs.md): Retrieve lab tests labs via the Junction API. Requires authentication with your team API key. - [Create a Test](https://docs.junction.com/api-reference/lab-testing/post-test.md): Create or submit lab tests via the Junction API. Requires authentication with your team API key. - [Update a Test](https://docs.junction.com/api-reference/lab-testing/patch-lab-test.md): Partially update lab tests via the Junction API. Requires authentication with your team API key. - [Get Markers for Lab Test](https://docs.junction.com/api-reference/lab-testing/lab-test-markers.md): Retrieve lab tests markers via the Junction API. Requires authentication with your team API key. - [Get Markers for Order Set](https://docs.junction.com/api-reference/lab-testing/order-set-marker.md): Create or submit lab tests list order set markers via the Junction API. Requires authentication with your team API key. - [Get Collection Instructions PDF for Lab Test](https://docs.junction.com/api-reference/lab-testing/lab-test-collection-instructions-pdf.md): Retrieve lab test collection instructions PDF via the Junction API. Requires authentication with your team API key. #### Results - [Get Results](https://docs.junction.com/api-reference/lab-testing/results/get-results.md): Retrieve order result via the Junction API. Requires authentication with your team API key. - [Get Results PDF](https://docs.junction.com/api-reference/lab-testing/results/get-results-pdf.md): Retrieve order result pdf via the Junction API. Requires authentication with your team API key. - [Get Results Metadata](https://docs.junction.com/api-reference/lab-testing/results/get-results-metadata.md): Retrieve order result metadata via the Junction API. Requires authentication with your team API key. - [Get Order Transaction Results](https://docs.junction.com/api-reference/lab-testing/results/get-order-transaction-results.md): Retrieve order transaction result via the Junction API. Requires authentication with your team API key. - [Get Order Transaction Results PDF](https://docs.junction.com/api-reference/lab-testing/results/get-order-transaction-results-pdf.md): Retrieve order transaction result pdf via the Junction API. Requires authentication with your team API key. #### Unmatched Results - [List Unmatched Results](https://docs.junction.com/api-reference/lab-testing/unmatched-results/list-unmatched-results.md): List lab results that require match review via the Junction API. Requires authentication with your team API key. - [Get Unmatched Result](https://docs.junction.com/api-reference/lab-testing/unmatched-results/get-unmatched-result.md): Retrieve a lab result that requires match review via the Junction API. Requires authentication with your team API key. - [Accept Unmatched Result](https://docs.junction.com/api-reference/lab-testing/unmatched-results/accept-unmatched-result.md): Accept a match for an unmatched lab result via the Junction API. Requires authentication with your team API key. - [Resolve Unmatched Result](https://docs.junction.com/api-reference/lab-testing/unmatched-results/resolve-unmatched-result.md): Reject or escalate an unmatched lab result via the Junction API. Requires authentication with your team API key. - [List Unmatched Result Test Cases](https://docs.junction.com/api-reference/lab-testing/unmatched-results/list-unmatched-result-test-cases.md): List the supported Sandbox unmatched-result test cases and their requirements via the Junction API. - [Create Unmatched Result Test](https://docs.junction.com/api-reference/lab-testing/unmatched-results/create-unmatched-result-test.md): Create a Sandbox test run that generates an unmatched lab result via the Junction API. - [Get Unmatched Result Test](https://docs.junction.com/api-reference/lab-testing/unmatched-results/get-unmatched-result-test.md): Retrieve the status and generated artifacts for a Sandbox unmatched-result test run via the Junction API. #### Lab Report Parsing - [Create Lab Report Parser Job](https://docs.junction.com/api-reference/lab-testing/lab-report-parsing/post-lab-report-parser-job.md): Create or submit lab report parser job via the Junction API. Requires authentication with your team API key. - [Get Lab Report Parser Job](https://docs.junction.com/api-reference/lab-testing/lab-report-parsing/get-lab-report-parser-job.md): Retrieve lab report parser job via the Junction API. Requires authentication with your team API key. #### Health Insurance - [Get search diagnosis](https://docs.junction.com/api-reference/lab-testing/insurance/search-diagnosis.md): Retrieve insurance search diagnosis via the Junction API. Requires authentication with your team API key. - [Get search payor](https://docs.junction.com/api-reference/lab-testing/insurance/search-payor-get.md): Retrieve insurance search payor via the Junction API. Requires authentication with your team API key. - [Create Payor](https://docs.junction.com/api-reference/lab-testing/insurance/create-payor.md): Create or submit payor via the Junction API. Requires authentication with your team API key. #### Compendium - [Compendium Search](https://docs.junction.com/api-reference/lab-testing/compendium/search.md): Create or submit compendium search via the Junction API. Requires authentication with your team API key. - [Compendium Convert](https://docs.junction.com/api-reference/lab-testing/compendium/convert.md): Create or submit compendium convert via the Junction API. Requires authentication with your team API key. ### Event Catalog #### Orders - [labtest.order.created](https://docs.junction.com/event-catalog/labtest.order.created.md): Webhook event sent when a new lab test order is created for a user through the Junction API. - [labtest.order.updated](https://docs.junction.com/event-catalog/labtest.order.updated.md): Webhook event sent when a lab test order progresses through its lifecycle, such as sample collection or results delivery. #### Results - [labtest.match_review.created](https://docs.junction.com/event-catalog/labtest.match_review.created.md): Webhook event sent when a lab result cannot be automatically matched to an order and requires review. - [labtest.match_review.updated](https://docs.junction.com/event-catalog/labtest.match_review.updated.md): Webhook event sent when the review status of an unmatched lab result changes, such as acceptance or rejection. - [labtest.result.critical](https://docs.junction.com/event-catalog/labtest.result.critical.md): Webhook event sent when a lab result contains a marker in the critical range, which can be life-threatening. #### Appointments - [labtest.appointment.created](https://docs.junction.com/event-catalog/labtest.appointment.created.md): Webhook event sent when an appointment is booked for a lab test order, such as an at-home phlebotomy visit. - [labtest.appointment.updated](https://docs.junction.com/event-catalog/labtest.appointment.updated.md): Webhook event sent when a lab test appointment changes, such as rescheduling, cancellation, or completion. #### Lab Report Parsing - [lab_report.parsing_job.created](https://docs.junction.com/event-catalog/lab_report.parsing_job.created.md): Webhook event sent when a parsing job is created for an uploaded lab report file. - [lab_report.parsing_job.updated](https://docs.junction.com/event-catalog/lab_report.parsing_job.updated.md): Webhook event sent when a lab report parsing job changes status, such as when parsing completes. ## Optional - [Changelog](https://docs.junction.com/changelog/lab-testing)