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

# Genetics

> Upload VCF/WGS or SNP-array data, queue interpretation, and read genetic pipeline results.

Genetics runs as a queued job. Upload a file, start analysis, and poll the job.
The hosted worker runs the bundled analyze-health pipeline (ClinVar, CPIC
pharmacogenomics, polygenic risk scores, aging hallmarks, and a Genomic
Longevity Index).

## Choose a provider first

If a user does not yet have genetic data, `GET /wgs-providers` returns a catalog
of WGS, exome, and SNP-array providers with pricing, turnaround, data formats,
raw-data access, and CLIA status. Filter by `type` and `region`.

## Upload and analyze

```bash theme={null}
# 1. Upload the file
curl -s "$HEALTH_API/imports/file" \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{
    "user_id": "'"$USER_ID"'",
    "organization_id": "'"$ORGANIZATION_ID"'",
    "category": "genetics",
    "filename": "genome.vcf",
    "text": "<vcf contents or use data_base64>"
  }'

# 2. Start analysis (returns a queued job)
curl -s "$HEALTH_API/genetics/analyze" \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"user_id":"'"$USER_ID"'","organization_id":"'"$ORGANIZATION_ID"'","source_ids":["'"$SOURCE_ID"'"]}'

# 3. Poll the job
curl -s "$HEALTH_API/genetics/jobs/$JOB_ID" -H "authorization: Bearer $TOKEN"
```

When complete, the analysis gains a `genetic_pipeline_analysis` interpretation
summarizing GLI, matched markers, CPIC matches, and ClinVar findings. Clinical
and medication findings are treated as educational until confirmed by a
qualified clinician.

## Reference modes

* **Compact (default):** bundled ClinVar-derived rsID reference, with no large
  download.
* **Full dbSNP (advanced):** broader rsID recovery. Requires dedicated worker
  capacity with persistent reference storage, available on paid plans.

## Ancestry

`POST /genetics/ancestry` validates source readiness and returns reference-panel
setup requirements. Ancestry proportions are returned once the ancestry worker
(1000 Genomes + PCA/admixture) is configured.