---
title: "Get biomarker details"
method: GET
path: "/api/v1/biomarkers/{slug}"
tags: ["Biomarkers"]
---

# Get biomarker details

`GET /api/v1/biomarkers/{slug}`

## Request

- Base URL: `https://www.vitalsvault.com`
- URL: `https://www.vitalsvault.com/api/v1/biomarkers/{slug}`
- Auth: none declared

Get comprehensive information about a specific biomarker

## Path parameters

- `slug` string, required

## Query parameters

- `include` string

## Response `200`

Successfully retrieved biomarker

- object
  - `success` boolean, required: Indicates if the request was successful
  - `data` object: Response data (only present if success is true)
    - `id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `categoryId` string, uuid
    - `categorySlug` string, required
    - `applicableGender` 'male' | 'female' | 'both'
    - `summary` string: Brief summary of the biomarker
    - `significance` string: Medical significance of the biomarker
    - `symptoms` string[]
    - `causes` string[]
    - `metaDescription` string: SEO meta description
    - `keyInsights` string[]
    - `loincCode` string
    - `loincName` string
    - `unit` string
    - `hasContent` boolean
    - `junctionMarkerId` string: Junction Health marker ID for lab integration
    - `includedInPackages` string[]
    - `seoVariations` string[]: Alternative search terms
    - `medicalReviewStatus` 'pending' | 'reviewed' | 'approved'
    - `lastMedicalReview` string, date-time
    - `viewCount` integer
    - `searchVolume` integer
    - `trendingScore` number, float
    - `lastUpdated` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `category` object
      - `id` string, uuid, required
      - `slug` string, required
      - `name` string, required
      - `description` string
      - `iconUrl` string, uri
      - `displayOrder` integer
      - `biomarkerCount` integer: Number of biomarkers in this category
      - `commonConditions` string[]
      - `keyBenefits` string[]
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `optimalRanges` object[]
      - `id` string, uuid
      - `gender` 'male' | 'female' | 'both', required
      - `ageMin` integer, required
      - `ageMax` integer, required
      - `optimalMin` number, required
      - `optimalMax` number, required
      - `normalMin` number
      - `normalMax` number
      - `unit` string, required
      - `source` string
      - `notes` string
      - `isPregnancySpecific` boolean
      - `pregnancyTrimester` integer
    - `nutritionGuidelines` object[]: Always empty. Retired 2026-09-29: the backing data is not available in production. Kept for response-shape compatibility.
      - `id` string, uuid
      - `purpose` 'increase' | 'decrease' | 'maintain', required
      - `recommendation` string, required
      - `foods` string[]
      - `supplements` string[]
      - `avoidFoods` string[]
      - `timing` string
      - `dosage` string
      - `interactions` string[]
      - `contraindications` string[]
    - `testingGuidelines` object[]: Always empty. Retired 2026-09-29: the backing data is not available in production. Kept for response-shape compatibility.
      - `id` string, uuid
      - `frequency` string, required
      - `conditions` string[], required
      - `fastingRequired` boolean
      - `bestTimeOfDay` string
      - `preparation` string[]
      - `interferingFactors` string[]
      - `relatedTests` string[]
    - `researchLinks` object[]: Always empty. Retired 2026-09-29: the backing data is not available in production. Kept for response-shape compatibility.
      - `id` string, uuid
      - `title` string, required
      - `url` string, uri, required
      - `publishDate` string, date
      - `authors` string[]
      - `journal` string
      - `type` 'clinical_trial' | 'meta_analysis' | 'review' | 'case_study' | 'guideline', required
      - `keyFindings` string[]
      - `relevanceScore` number, float
  - `error` object
    - `code` string, required: Error code for programmatic handling
    - `message` string, required: Human-readable error message
    - `details` string: Additional error details
  - `meta` object
    - `queryTime` integer: Query execution time in milliseconds
    - `cached` boolean: Whether the response was served from cache

## Other responses

- `404`: Resource not found
- `500`: Internal server error

---

[API](https://skmtc.dev/vitalsvault/apis/vitals-vault-educational-api.md) · [All operations](https://skmtc.dev/vitalsvault/apis/vitals-vault-educational-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vitalsvault/apis/vitals-vault-educational-api/revisions/957d19299c33?raw)