API Reference

Submit a new analysis job. Returns a job ID for status polling.

{
  "rsids": ["rs429358", "rs7412", "rs1801133"],
  "top_n": 3
}

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending"
}

curl -X POST https://api.genocode.ai/api/v1/analyze \
  -H "Content-Type: application/json" \
  -H "X-API-Key: geno_YOUR_KEY" \
  -d '{"rsids": ["rs429358", "rs7412"], "top_n": 3}'

Check the status and progress of an analysis job. Poll every 2 seconds until status is 'completed' or 'failed'.

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "running",
  "progress": 45,
  "progress_message": "Annotating variants (7/15)...",
  "report_html_url": null,
  "report_pdf_url": null,
  "error": null,
  "candidates_count": 0,
  "targets_count": 0
}

curl https://api.genocode.ai/api/v1/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: geno_YOUR_KEY"

Retrieve the completed HTML report. Also available as PDF at /api/v1/reports/{id}.pdf.

(HTML document)

# HTML report
curl https://api.genocode.ai/api/v1/reports/a1b2c3d4.html \
  -H "X-API-Key: geno_YOUR_KEY" -o report.html

# PDF report
curl https://api.genocode.ai/api/v1/reports/a1b2c3d4.pdf \
  -H "X-API-Key: geno_YOUR_KEY" -o report.pdf