Get Available Biomarkers

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

GET /v3/lab_tests/markers

cURL

curl --request GET \
     --url '{{BASE_URL}}/v3/lab_tests/markers' \
     --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_markers()

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

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

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

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().getMarkers();

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.GetMarkers(context.TODO(), &junction.GetMarkersLabTestsRequest{})
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", response)

Response

{
  "markers": [
      {
          "id": 202,
          "name": "Acetylcholine Receptor (AChR) Antibodies, Complete Profile with Reflex to MuSK Antibodies",
          "slug": "acetylcholine-receptor-achr-antibodies-complete-profile-with-reflex-to-musk-antibodies",
          "description": "Acetylcholine Receptor (AChR) Antibodies, Complete Profile with Reflex to MuSK Antibodies",
          "lab_id": 6,
          "provider_id": "165605",
          "type": "biomarker",
          "unit": null,
          "price": "N/A",
          "expected_results": [
              {
                  "id": 2938,
                  "name": "AChR Blocking Abs, Serum",
                  "slug": "achr-blocking-abs-serum",
                  "lab_id": 6,
                  "provider_id": "085927",
                  "loinc": {
                      "id": 3514,
                      "name": "Acetylcholine receptor blocking Ab Qn (S)",
                      "slug": "acetylcholine-receptor-blocking-ab-qn-s",
                      "code": "11561-8",
                      "unit": "%{inhibition}"
                  }
              },
              {
                  "id": 2939,
                  "name": "AChR Binding Abs, Serum",
                  "slug": "achr-binding-abs-serum",
                  "lab_id": 6,
                  "provider_id": "085904",
                  "loinc": {
                      "id": 3174,
                      "name": "Acetylcholine receptor binding Ab (S) [Moles/Vol]",
                      "slug": "acetylcholine-receptor-binding-ab-s-moles-vol",
                      "code": "11034-6",
                      "unit": "nmol/L"
                  }
              },
              {
                  "id": 2940,
                  "name": "AChR-modulating Ab",
                  "slug": "achr-modulating-ab",
                  "lab_id": 6,
                  "provider_id": "505199",
                  "loinc": {
                      "id": 61121,
                      "name": "Acetylcholine receptor modulation Ab FC Ql (S)",
                      "slug": "acetylcholine-receptor-modulation-ab-fc-ql-s",
                      "code": "99062-2",
                      "unit": null
                  }
              }
          ]
      }
  ],
  "total": 2,
  "page": 1,
  "size": 2
}

cURL

curl --request GET \
     --url '{{BASE_URL}}/v3/lab_tests/markers' \
     --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_markers()

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

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

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

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().getMarkers();

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.GetMarkers(context.TODO(), &junction.GetMarkersLabTestsRequest{})
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", response)

Response

{
  "markers": [
      {
          "id": 202,
          "name": "Acetylcholine Receptor (AChR) Antibodies, Complete Profile with Reflex to MuSK Antibodies",
          "slug": "acetylcholine-receptor-achr-antibodies-complete-profile-with-reflex-to-musk-antibodies",
          "description": "Acetylcholine Receptor (AChR) Antibodies, Complete Profile with Reflex to MuSK Antibodies",
          "lab_id": 6,
          "provider_id": "165605",
          "type": "biomarker",
          "unit": null,
          "price": "N/A",
          "expected_results": [
              {
                  "id": 2938,
                  "name": "AChR Blocking Abs, Serum",
                  "slug": "achr-blocking-abs-serum",
                  "lab_id": 6,
                  "provider_id": "085927",
                  "loinc": {
                      "id": 3514,
                      "name": "Acetylcholine receptor blocking Ab Qn (S)",
                      "slug": "acetylcholine-receptor-blocking-ab-qn-s",
                      "code": "11561-8",
                      "unit": "%{inhibition}"
                  }
              },
              {
                  "id": 2939,
                  "name": "AChR Binding Abs, Serum",
                  "slug": "achr-binding-abs-serum",
                  "lab_id": 6,
                  "provider_id": "085904",
                  "loinc": {
                      "id": 3174,
                      "name": "Acetylcholine receptor binding Ab (S) [Moles/Vol]",
                      "slug": "acetylcholine-receptor-binding-ab-s-moles-vol",
                      "code": "11034-6",
                      "unit": "nmol/L"
                  }
              },
              {
                  "id": 2940,
                  "name": "AChR-modulating Ab",
                  "slug": "achr-modulating-ab",
                  "lab_id": 6,
                  "provider_id": "505199",
                  "loinc": {
                      "id": 61121,
                      "name": "Acetylcholine receptor modulation Ab FC Ql (S)",
                      "slug": "acetylcholine-receptor-modulation-ab-fc-ql-s",
                      "code": "99062-2",
                      "unit": null
                  }
              }
          ]
      }
  ],
  "total": 2,
  "page": 1,
  "size": 2
}

Authorizations

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

Vital Team API Key

Query Parameters

lab_id · integer[] | null

The identifier Vital assigned to a lab partner.

lab_slug · string | null

The slug of the lab for these markers. If both lab_id and lab_slug are provided, lab_slug will be used.

name · string · default: ""

The name or test code of an individual biomarker or a panel.

a_la_carte_enabled · boolean | null

lab_account_id · string<uuid> | null

The lab account ID. This lab account is used to determine the availability of markers and lab tests.

page · integer · default: 1

Required range: x >= 1

size · integer · default: 50

Required range: 1 <= x <= 100

Response

200

application/json

Successful Response

markers · ClientFacingMarkerComplete · object[] · required

Show child attributes

total · integer | null · required

Required range: x >= 0

page · integer | null · required

Required range: x >= 0

size · integer | null · required

Required range: x >= 0

pages · integer | null · required

Required range: x >= 0