> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Lab Results

> Retrieve clinical and genetic lab results for a home kit order

Retrieve clinical and genetic lab results for a home kit order, 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](/api/documents/download-document) to download lab report PDFs referenced in the `documents` array.

## Request

### Path parameters

<ParamField path="id" type="string" required>
  Unique identifier (UUID) of the home kit order to retrieve results for.
</ParamField>

## Response

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

<ResponseField name="status" type="string" required>
  Overall results status. One of `in_progress` (some submissions still processing) or `completed`
  (all done).
</ResponseField>

<ResponseField name="clinical_results" type="object[]" required>
  Array of clinical biomarker results.

  <Expandable title="clinical result object">
    <ResponseField name="status" type="string" required>
      Result status: `planned` (awaiting), `received` (from lab), or `corrected` (human-revised).
    </ResponseField>

    <ResponseField name="biomarker_id" type="integer" required>
      Biomarker identifier.
    </ResponseField>

    <ResponseField name="biomarker_name" type="string" required>
      Biomarker display name.
    </ResponseField>

    <ResponseField name="category" type="string">
      Biomarker category (e.g., Hormones, Vitamins). May be `null`.
    </ResponseField>

    <ResponseField name="value" type="number">
      Effective result value (corrected if available, otherwise raw). May be `null`.
    </ResponseField>

    <ResponseField name="value_operator" type="string">
      Comparison operator for the value: `eq` (equals), `lt` (less than), or `gt` (greater than). May be `null`.
    </ResponseField>

    <ResponseField name="unit_id" type="integer">
      Measurement unit identifier. May be `null`.
    </ResponseField>

    <ResponseField name="unit" type="string">
      Measurement unit display name. May be `null`.
    </ResponseField>

    <ResponseField name="reference_range_lab" type="object">
      Reference ranges as reported by the lab. May be `null`.

      <Expandable title="reference range">
        <ResponseField name="normal_min" type="number">Lower bound of normal range. May be `null`.</ResponseField>
        <ResponseField name="normal_max" type="number">Upper bound of normal range. May be `null`.</ResponseField>
        <ResponseField name="optimal_min" type="number">Lower bound of optimal range. May be `null`.</ResponseField>
        <ResponseField name="optimal_max" type="number">Upper bound of optimal range. May be `null`.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="reference_range_aniva" type="object">
      Aniva-curated reference ranges adjusted for age, sex, and pregnancy status. May be `null`.

      <Expandable title="reference range">
        <ResponseField name="normal_min" type="number">Lower bound of normal range. May be `null`.</ResponseField>
        <ResponseField name="normal_max" type="number">Upper bound of normal range. May be `null`.</ResponseField>
        <ResponseField name="optimal_min" type="number">Lower bound of optimal range. May be `null`.</ResponseField>
        <ResponseField name="optimal_max" type="number">Upper bound of optimal range. May be `null`.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="tested_at" type="string">
      Date the test was performed in `YYYY-MM-DD` format. May be `null`.
    </ResponseField>

    <ResponseField name="comment" type="string">
      Optional comment on the result. May be `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="genetic_results" type="object[]" required>
  Array of genetic biomarker results.

  <Expandable title="genetic result object">
    <ResponseField name="status" type="string" required>
      Result status: `planned` (awaiting) or `received` (from lab).
    </ResponseField>

    <ResponseField name="biomarker_id" type="integer" required>
      Biomarker (gene) identifier.
    </ResponseField>

    <ResponseField name="gene" type="string" required>
      Gene symbol (e.g., APOE, MTHFR).
    </ResponseField>

    <ResponseField name="genotype" type="string">
      Genotype display (e.g., E3/E4). May be `null`.
    </ResponseField>

    <ResponseField name="clinical_significance" type="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`.
    </ResponseField>

    <ResponseField name="risk_description" type="string">
      Risk description for this genotype. May be `null`.
    </ResponseField>

    <ResponseField name="tested_at" type="string">
      Date the test was performed in `YYYY-MM-DD` format. May be `null`.
    </ResponseField>

    <ResponseField name="comment" type="string">
      Optional comment on the result. May be `null`.
    </ResponseField>

    <ResponseField name="variants" type="object[]" required>
      Detected genetic variants.

      <Expandable title="variant object">
        <ResponseField name="name" type="string" required>Variant common name (e.g., APOE E4).</ResponseField>
        <ResponseField name="clinical_significance" type="string">Variant-level clinical significance. May be `null`.</ResponseField>
        <ResponseField name="description" type="string">Variant description. May be `null`.</ResponseField>
        <ResponseField name="hgvs_c" type="string">HGVS coding DNA notation. May be `null`.</ResponseField>
        <ResponseField name="hgvs_p" type="string">HGVS protein notation. May be `null`.</ResponseField>

        <ResponseField name="conditions" type="object[]" required>
          Associated conditions.

          <Expandable title="condition object">
            <ResponseField name="condition" type="string" required>Condition/disease name.</ResponseField>
            <ResponseField name="association_description" type="string">Description of the variant-condition association. May be `null`.</ResponseField>
            <ResponseField name="badge" type="string">Short badge text for display. May be `null`.</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="snvs" type="object[]" required>
          Single nucleotide variants defining this variant.

          <Expandable title="SNV object">
            <ResponseField name="rs_id" type="string" required>dbSNP identifier (e.g., rs429358).</ResponseField>
            <ResponseField name="allele" type="string" required>Variant allele (`A`, `C`, `G`, `T`, `del`, `ins`, or `undetermined`).</ResponseField>
            <ResponseField name="reference_allele" type="string" required>Population reference allele.</ResponseField>
            <ResponseField name="hgvs_c" type="string">HGVS coding DNA notation. May be `null`.</ResponseField>
            <ResponseField name="hgvs_p" type="string">HGVS protein notation. May be `null`.</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="documents" type="object[]" required>
  Lab report documents. Use `GET /api/v1/documents/{id}` to download each file.

  <Expandable title="document object">
    <ResponseField name="id" type="string" required>File identifier (UUID). Pass to [Download Document](/api/documents/download-document) to retrieve the file.</ResponseField>
    <ResponseField name="file_name" type="string" required>Original file name.</ResponseField>
  </Expandable>
</ResponseField>

## 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 home kit order is outside your access context. |
| `404`  | Home kit order not found.                                                                                             |
| `500`  | Internal server error.                                                                                                |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results \
    --header 'x-api-key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"
      }
    ]
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Home kit order not found"
  }
  ```
</ResponseExample>