Skip to main content
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

# 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.