The Genome Computer API

curl https://staging.api.genome.computer/v1/test/orders/ord_xxx/advance \
  -X POST \
  -H "Authorization: Bearer $GC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"completed"}'

{
  "order_id": "ord_01JZ8N8A4P2Y",
  "type": "wgs_30x",
  "client_name": "Acme Health",
  "user_reference": "user_123",
  "status": "created",
  "status_label": "Order created",
  "activation_id": "ACT-7HD2-9QK4",
  "activation_url": "https://sample.bio/activate/ACT-7HD2-9QK4",
  "deliverables": ["genome_bundle", "vcf", "fastq"],
  "retention": "hosted_runtime",
  "price_cents": 69900,
  "currency": "usd"
}

{
  "order_id": "ord_01JZ8N8A4P2Y",
  "status": "completed",
  "expires_at": "2026-05-21T12:30:00.000Z",
  "files": [
    {
      "type": "genome_bundle",
      "filename": "gen_test_nutrition_001.genome.zip",
      "url": "https://signed-download-url.example/..."
    },
    {
      "type": "vcf",
      "filename": "gen_test_nutrition_001.vcf.gz",
      "url": "https://signed-download-url.example/..."
    },
    {
      "type": "fastq",
      "filename": "gen_test_nutrition_001_R1.fastq.gz",
      "url": "https://signed-download-url.example/..."
    }
  ]
}

{
  "question": "How should my app explain peptide-related genetic context?",
  "response_length": "medium"
}

{
  "answer_id": "ans_4az91r",
  "genome_id": "gen_test_nutrition_001",
  "response_length": "medium",
  "answer": "This genome can support peptide-related decision making indirectly. The relevant genetic context is around metabolic handling, inflammation and recovery pathways, connective tissue repair, cardiovascular safety, endocrine signaling, and medication response. It should be presented as inherited pathway context for clinician review, not as a peptide prescription, deficiency assessment, or yes/no treatment recommendation.",
  "citations": [
    {
      "source": "interpretation_artifact",
      "version": "2026.05.1"
    }
  ],
  "safety": {
    "clinical_advice": false,
    "requires_clinician_review": true
  },
  "usage": {
    "input_tokens": 2190,
    "output_tokens": 142,
    "model_name": "gpt-5.5"
  }
}

{
  "genome_id": "gen_test_nutrition_001",
  "domain": "nutrition",
  "detail_level": "standard"
}

{
  "context_id": "ctx_7v1a9k",
  "genome_id": "gen_test_nutrition_001",
  "domain": "nutrition",
  "detail_level": "standard",
  "summary": "Nutrition context includes folate handling, caffeine response, lactose persistence, lipid metabolism, and selected cardiometabolic markers.",
  "structured_findings": [
    {
      "id": "nutr_folate_mthfr",
      "title": "Folate and methylation context",
      "evidence_level": "moderate",
      "genes": ["MTHFR", "MTR", "MTRR"],
      "client_display": "Show as inherited folate-pathway context, not as a diagnosis or supplement instruction."
    }
  ],
  "citations": [
    {
      "source": "ClinVar",
      "accessed_at": "2026-05-20",
      "url": "https://www.ncbi.nlm.nih.gov/clinvar/"
    }
  ],
  "interpretation_version": "2026.05.1"
}

{
  "error": {
    "code": "not_found",
    "message": "Genome not found."
  }
}

{
  "error": {
    "code": "genome_not_ready",
    "message": "Genome runtime is still being created. Retry after the genome.created webhook fires.",
    "retryable": true
  }
}

curl https://staging.api.genome.computer/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer $GC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.acmehealth.com/webhooks/genome-computer",
    "event_types": ["order.completed", "genome.created", "panel.generated"]
  }'

{
  "id": "evt_7c991x",
  "type": "order.completed",
  "created_at": "2026-05-21T10:22:11.000Z",
  "data": {
    "order_id": "ord_01JZ8N8A4P2Y",
    "genome_id": "gen_test_nutrition_001",
    "deliverables": ["genome_bundle", "vcf", "fastq"],
    "files_url": "https://api.genome.computer/v1/orders/ord_01JZ8N8A4P2Y/files"
  }
}

import crypto from "node:crypto";

function verifyGenomeComputerWebhook(req, rawBody, signingSecret) {
  const timestamp = req.headers["gc-webhook-timestamp"];
  const signature = req.headers["gc-webhook-signature"]?.replace("v1=", "");
  if (!timestamp || !signature) return false;

  const expected = crypto
    .createHmac("sha256", signingSecret)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");
  if (signature.length !== expected.length) return false;

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

{
  "id": "evt_2n81qa",
  "type": "genome.created",
  "created_at": "2026-05-21T10:24:13.000Z",
  "data": {
    "genome": {
      "genome_id": "gen_test_nutrition_001",
      "status": "active",
      "interpretation_version": "2026.05.1"
    }
  }
}