Lab Accounts

Lab accounts contain the configuration Junction needs to place orders and receive results from a specific lab. Each customer-owned lab account belongs to an Org and can be linked to one or more Teams. Junction platform accounts are managed by Junction and are not owned by a customer Org. A Team can have multiple lab accounts linked, including multiple accounts for the same lab, but each order uses only one lab account.

Ordering with a lab account ID

You only need to provide lab_account_id if you have your own account with a core lab. If your Team uses Junction’s platform accounts, you do not need to provide it when placing an order.

If you have your own core lab account, provide lab_account_id when you want an order to be placed with that account rather than Junction’s platform account. This makes your intended account explicit and ensures that Junction uses that lab account’s configuration when routing the order. Your lab account must be active, linked to your Team, and associated with the lab selected for the order. The relevant fields in the Create Order request are:

{
  "lab_account_id": "<lab_account_id>",
  "order_set": {
    "lab_test_ids": ["<lab_test_id>"]
  }
}

Before placing an order, use the Get Lab Accounts (Team-level) endpoint to retrieve the lab accounts available to your Team and select the appropriate id.

How Junction selects a lab account when `lab_account_id` is omitted

When lab_account_id is omitted from a Create Order request, Junction evaluates the lab accounts linked to your Team for the lab selected by the order:

Lab accounts linked to your Team for the selected lab	Account selection
No lab accounts are linked	Junction uses its platform account when one is available to your Team for that lab.
Exactly one active lab account is linked	Junction uses your active linked account.
More than one active lab account is linked	Junction does not select an account because it cannot determine which of your accounts you intended to use.
Lab accounts are linked, but none is active	Junction does not fall back to its platform account.

If more than one active lab account is linked to your Team for the selected lab, the order may be rejected unless you provide lab_account_id. Junction cannot place the order if no active account is available.

Billing types

For an explanation of each available billing_type, see Billing Types in Junction’s System. Each lab account defines the billing types it supports and the states where each type is available. Each lab account object returned by Get Lab Accounts (Team-level) includes an allowed_billing field such as:

{
  "allowed_billing": {
    "client_bill": ["AZ", "CA", "NY"],
    "commercial_insurance": ["AZ", "CA"]
  }
}

Each key is a supported billing_type, and its value lists the patient states where that billing type is available for the account. If a billing type is absent, the lab account does not support it. If the patient’s state is absent from its list, that billing type is not available for the account in that state. The billing_type in a Create Order request must be supported by the lab account used for the order. For the additional requirements associated with commercial_insurance, see Insurance Ordering.

Retrieving and managing lab accounts

Use the Team-level endpoint to retrieve the accounts available to your Team for ordering. Use the Org-level endpoint to retrieve accounts across your Org and review which Teams are linked to each account.

Topic	Org-level Get Lab Accounts	Team-level Get Lab Accounts
Scope	Returns lab accounts for the Org, across Teams	Returns lab accounts available to the current Team
Typical user	Org admin or platform integrator	Team-scoped integration
Best use case	Org-wide visibility and management	Team-specific runtime operations
Team linkage	Shows which Teams are linked to each account	Returns only accounts linked to the current Team

Manage Team linkage through the Update Lab Account Teams (Org-level) endpoint. There is no Team-level endpoint for updating lab account linkage. You can also view lab accounts tied to your Org on the Lab Interface Requests page of your Org Config in the Junction dashboard.

Lab certification

Before a customer-owned lab account can be used operationally through Junction, the laboratory may require certification. Certification is an end-to-end test that confirms the account is configured correctly and that Junction can successfully place an order with the lab and receive the resulting report. Certification requirements vary by laboratory and account. The required test cases, coordination steps, and review process may differ, but you should expect most certifications to take several weeks to complete with the lab. Junction cannot begin certification until your production access has been approved and granted. Once production access is available, work with your Customer Success Manager (CSM) to confirm the lab-specific requirements, expected timeline, and next steps. Junction will provide additional details and status updates throughout the process. You can also continue building using Junction’s platform accounts while certification for your own lab account is in progress.

Contact Junction Customer Support to create a lab account or resolve a lab account issue.

Getting Started

Ordering Workflows

Walk-in (Patient Service Center) Orders

Mobile Phlebotomy Orders

At-Home Test Kit Orders

On-site Collection Orders

Results and Follow-up

Lab Report Parsing

Ordering with a lab account ID

How Junction selects a lab account when `lab_account_id` is omitted

Billing types

Retrieving and managing lab accounts

Lab certification

​Ordering with a lab account ID

​How Junction selects a lab account when lab_account_id is omitted

​Billing types

​Retrieving and managing lab accounts

​Lab certification

Ordering with a lab account ID

How Junction selects a lab account when `lab_account_id` is omitted

Billing types

Retrieving and managing lab accounts

Lab certification