Lab accounts encapsulate the information needed to place orders and receive results for a particular lab. They are tied to Orgs and can be dynamically linked to as many Teams within the Org as desired.
When an active lab account is linked to a Team, that Team can place orders using that lab account. A Team can have multiple lab accounts linked, even for a single lab, but an individual order must be placed with a single lab account. The Create Order endpoint accepts a lab_account_id to specify the lab account.
If lab_account_id is not provided when placing an order, we will try to determine an appropriate lab account based on available information, but if we cannot unambigously find one lab account that should be used, we might not be able to place the order. We recommend including the lab_account_id when possible.
Which endpoint should I use?
Use both endpoints for different jobs. They are complementary, not interchangeable.
| 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 one team context |
| Typical user | Org admin or platform integrator | Team-scoped integration |
| Best use case | Org-wide visibility and management | Team-specific runtime operations |
| Filtering behavior | Can be used to review accounts at the Org level and understand team linkage | Returns only accounts available in the current team context |
- Use the team-level endpoint when operating within one team context.
- Use the org-level endpoint when you need cross-team, org-level management views.
- There is no team-level endpoint for updating lab account team linkage.
Practical examples:
- Org-level endpoint: An operations admin audits all lab accounts in the Org and confirms which teams are linked to each account.
- Team-level endpoint: A team-specific ordering workflow fetches only the lab accounts that team can use before creating an order.
You can also view lab accounts tied to your Org on the Lab Interface Requests page of your Org Config in the Junction dashboard. 
