Get All Available Labs

Retrieve lab tests labs via the Junction API. Requires authentication with your team API key.

GET /v3/lab_tests/labs

cURL

curl --request GET \
     --url '{{BASE_URL}}/v3/lab_tests/labs' \
     --header 'accept: application/json' \
     --header 'x-vital-api-key: YOUR_API_KEY'

from junction import Junction
from junction.environment import JunctionEnvironment

client = Junction(
    api_key="YOUR_API_KEY",
    environment=JunctionEnvironment.SANDBOX,
)

data = client.lab_tests.get_labs()

import { JunctionClient, JunctionEnvironment } from "@junction-api/sdk";

const client = new JunctionClient({
    apiKey: "YOUR_API_KEY",
    environment: JunctionEnvironment.Sandbox,
});

const data = await client.labTests.getLabs();

import com.junction.api.Junction;
import com.junction.api.core.Environment;

Junction client = Junction.builder()
    .apiKey("YOUR_API_KEY")
    .environment(Environment.SANDBOX)
    .build();

var data = client.labTests().getLabs();

import (
    "context"

    junction "github.com/junction-api/junction-go"
    "github.com/junction-api/junction-go/client"
    "github.com/junction-api/junction-go/option"
)

c := client.NewClient(
    option.WithApiKey("YOUR_API_KEY"),
    option.WithBaseURL(junction.Environments.Sandbox),
)

response, err := c.LabTests.GetLabs(context.TODO())
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", response)

Response

[
  {
    "id": 1,
    "slug": "labcorp",
    "name": "LabCorp",
    "first_line_address": "123 Main St",
    "city": "San Francisco",
    "zipcode": "91789",
    "collection_methods": ["at_home_phlebotomy", "walk_in_test"],
    "sample_types": ["saliva", "serum"]
  }
]

cURL

curl --request GET \
     --url '{{BASE_URL}}/v3/lab_tests/labs' \
     --header 'accept: application/json' \
     --header 'x-vital-api-key: YOUR_API_KEY'

from junction import Junction
from junction.environment import JunctionEnvironment

client = Junction(
    api_key="YOUR_API_KEY",
    environment=JunctionEnvironment.SANDBOX,
)

data = client.lab_tests.get_labs()

import { JunctionClient, JunctionEnvironment } from "@junction-api/sdk";

const client = new JunctionClient({
    apiKey: "YOUR_API_KEY",
    environment: JunctionEnvironment.Sandbox,
});

const data = await client.labTests.getLabs();

import com.junction.api.Junction;
import com.junction.api.core.Environment;

Junction client = Junction.builder()
    .apiKey("YOUR_API_KEY")
    .environment(Environment.SANDBOX)
    .build();

var data = client.labTests().getLabs();

import (
    "context"

    junction "github.com/junction-api/junction-go"
    "github.com/junction-api/junction-go/client"
    "github.com/junction-api/junction-go/option"
)

c := client.NewClient(
    option.WithApiKey("YOUR_API_KEY"),
    option.WithBaseURL(junction.Environments.Sandbox),
)

response, err := c.LabTests.GetLabs(context.TODO())
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", response)

Response

[
  {
    "id": 1,
    "slug": "labcorp",
    "name": "LabCorp",
    "first_line_address": "123 Main St",
    "city": "San Francisco",
    "zipcode": "91789",
    "collection_methods": ["at_home_phlebotomy", "walk_in_test"],
    "sample_types": ["saliva", "serum"]
  }
]

Authorizations

x-vital-api-key · string · header · required

Vital Team API Key

Response

200 - application/json

Successful Response

id · integer · required

slug · string · required

name · string · required

first_line_address · string · required

city · string · required

zipcode · string · required

collection_methods · enum<string>[] · required

The method used to perform a lab test. ℹ️ This enum is non-exhaustive.

Available options: testkit, walk_in_test, at_home_phlebotomy, on_site_collection

sample_types · enum<string>[] · required

The type of sample used to perform a lab test. ℹ️ This enum is non-exhaustive.

Available options: dried_blood_spot, arm_collector, serum, saliva, urine, stool