Get Lab Results

GET

api

appointments

{id}

results

curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/results \
  --header 'x-api-key: YOUR_API_KEY'

{
  "status": "in_progress",
  "clinical_results": [
    {
      "status": "received",
      "biomarker_id": 42,
      "biomarker_name": "Vitamin D (25-OH)",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_aniva": {
        "normal_min": 30,
        "normal_max": 80,
        "optimal_min": 40,
        "optimal_max": 60
      },
      "tested_at": "2026-04-05",
      "comment": null
    },
    {
      "status": "planned",
      "biomarker_id": 87,
      "biomarker_name": "TSH",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_aniva": null,
      "tested_at": null,
      "comment": null
    }
  ],
  "genetic_results": [
    {
      "status": "received",
      "biomarker_id": 201,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "lab-report-2026-04-05.pdf"
    }
  ]
}

{
  "error": "Appointment not found"
}

Retrieve clinical and genetic lab results for an appointment, along with document references for lab report PDFs. Results include planned tests (status planned) alongside received results, so you can track what is still pending. Use Download Document to download lab report PDFs referenced in the documents array.

Request

Path parameters

string

required

Unique identifier (UUID) of the appointment to retrieve results for.

Response

On success, the API returns 200 OK with the results object.

string

required

Overall results status. One of in_progress (some submissions still processing) or completed (all done).

object[]

required

Array of clinical biomarker results.

Show clinical result object

string

required

Result status: planned (awaiting), received (from lab), or corrected (human-revised).

integer

required

Biomarker identifier.

string

required

Biomarker display name.

string

Biomarker category (e.g., Hormones, Vitamins). May be null.

number

Effective result value (corrected if available, otherwise raw). May be null.

string

Comparison operator for the value: eq (equals), lt (less than), or gt (greater than). May be null.

integer

Measurement unit identifier. May be null.

string

Measurement unit display name. May be null.

object

Reference ranges as reported by the lab. May be null.

Show reference range

number

Lower bound of normal range. May be null.

number

Upper bound of normal range. May be null.

number

Lower bound of optimal range. May be null.

number

Upper bound of optimal range. May be null.

object

Aniva-curated reference ranges adjusted for age, sex, and pregnancy status. May be null.

Show reference range

number

Lower bound of normal range. May be null.

number

Upper bound of normal range. May be null.

number

Lower bound of optimal range. May be null.

number

Upper bound of optimal range. May be null.

string

Date the test was performed in YYYY-MM-DD format. May be null.

string

Optional comment on the result. May be null.

object[]

required

Array of genetic biomarker results.

Show genetic result object

string

required

Result status: planned (awaiting) or received (from lab).

integer

required

Biomarker (gene) identifier.

string

required

Gene symbol (e.g., APOE, MTHFR).

string

Genotype display (e.g., E3/E4). May be null.

string

Overall clinical significance. One of pathogenic, likely_pathogenic, uncertain, likely_benign, benign, high_risk, moderate_risk, low_risk, protective, drug_response, poor_metabolizer, or rapid_metabolizer. May be null.

string

Risk description for this genotype. May be null.

string

Date the test was performed in YYYY-MM-DD format. May be null.

string

Optional comment on the result. May be null.

object[]

required

Detected genetic variants.

Show variant object

string

required

Variant common name (e.g., APOE E4).

string

Variant-level clinical significance. May be null.

string

Variant description. May be null.

string

HGVS coding DNA notation. May be null.

string

HGVS protein notation. May be null.

object[]

required

Associated conditions.

Show condition object

string

required

Condition/disease name.

string

Description of the variant-condition association. May be null.

string

Short badge text for display. May be null.

object[]

required

Single nucleotide variants defining this variant.

Show SNV object

string

required

dbSNP identifier (e.g., rs429358).

string

required

Variant allele (A, C, G, T, del, ins, or undetermined).

string

required

Population reference allele.

string

HGVS coding DNA notation. May be null.

string

HGVS protein notation. May be null.

object[]

required

Lab report documents. Use GET /api/v1/documents/{id} to download each file.

Show document object

string

required

File identifier (UUID). Pass to Download Document to retrieve the file.

string

required

Original file name.

Error responses

Status	Description
`400`	Invalid ID format — the provided value is not a valid UUID.
`403`	Forbidden — your API key does not have access to this operation or the appointment is outside your access context.
`404`	Appointment not found.
`500`	Internal server error.

curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/results \
  --header 'x-api-key: YOUR_API_KEY'

{
  "status": "in_progress",
  "clinical_results": [
    {
      "status": "received",
      "biomarker_id": 42,
      "biomarker_name": "Vitamin D (25-OH)",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_aniva": {
        "normal_min": 30,
        "normal_max": 80,
        "optimal_min": 40,
        "optimal_max": 60
      },
      "tested_at": "2026-04-05",
      "comment": null
    },
    {
      "status": "planned",
      "biomarker_id": 87,
      "biomarker_name": "TSH",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_aniva": null,
      "tested_at": null,
      "comment": null
    }
  ],
  "genetic_results": [
    {
      "status": "received",
      "biomarker_id": 201,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "lab-report-2026-04-05.pdf"
    }
  ]
}

{
  "error": "Appointment not found"
}

Confirm Blood Draw

List Appointment Shipments

curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/results \
  --header 'x-api-key: YOUR_API_KEY'

{
  "status": "in_progress",
  "clinical_results": [
    {
      "status": "received",
      "biomarker_id": 42,
      "biomarker_name": "Vitamin D (25-OH)",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_aniva": {
        "normal_min": 30,
        "normal_max": 80,
        "optimal_min": 40,
        "optimal_max": 60
      },
      "tested_at": "2026-04-05",
      "comment": null
    },
    {
      "status": "planned",
      "biomarker_id": 87,
      "biomarker_name": "TSH",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_aniva": null,
      "tested_at": null,
      "comment": null
    }
  ],
  "genetic_results": [
    {
      "status": "received",
      "biomarker_id": 201,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "lab-report-2026-04-05.pdf"
    }
  ]
}

{
  "error": "Appointment not found"
}

Health

Profiles

Appointments

Home Kit Orders

Biomarkers

Panels

Units

Locations

Documents

Shipments

Get Lab Results

Request

Path parameters

Response

Error responses

​Request

​Path parameters

​Response

​Error responses

Request

Path parameters

Response

Error responses