Methods, paths, request fields, and response shapes for the genome.computer API. Endpoints are shared by staging and production unless marked as staging-only.
Send the API key in the Authorization header. Staging keys start with gc_test_. Production keys start with gc_live_.
Authorization: Bearer $GC_API_KEYThe API also exposes machine-readable OpenAPI JSON and Swagger UI for internal testing.
The table below is the daily working reference for partner engineers.
/v1/ordersCreate a 30x sequencing order.
/v1/ordersList recent orders.
/v1/orders/{order_id}Read order status and activation details.
/v1/orders/{order_id}/eventsRead order lifecycle events.
/v1/orders/{order_id}/shipmentRead shipment carrier and tracking data.
/v1/orders/{order_id}/filesReturn signed links for completed deliverables.
/v1/uploads/vcfUpload an existing VCF.
/v1/conversionsConvert an uploaded VCF into a .genome bundle.
/v1/genomesList hosted genomes.
/v1/genomes/{genome_id}Read hosted genome runtime metadata.
/v1/genomes/{genome_id}/bundleDownload a signed .genome bundle link.
/v1/genomes/{genome_id}/retentionChange whether the genome is hosted or deleted.
/v1/genomes/{genome_id}/interpretations/latestRead the latest interpretation record.
/v1/genomes/{genome_id}/interpretations/latest/artifactRead the full underlying interpretation artifact.
/v1/panelsList genetic insight panel definitions.
/v1/genomes/{genome_id}/panels/{panel_id}/buildBuild a curated genetic insight panel.
/v1/genomes/{genome_id}/askAsk a bounded natural-language genome question.
/v1/context/buildAdvanced: build deterministic structured context.
/v1/webhooksRegister lifecycle webhook endpoints.
/v1/webhooksList webhook endpoints.
/v1/webhooks/{webhook_id}Disable a webhook endpoint.
/v1/usageInspect metered events.
/v1/test/orders/{order_id}/advanceAdvance a staging-only sandbox order.
/v1/test/genomes/seedSeed the synthetic staging genome fixture.
/v1/test/genomesList seeded synthetic staging genomes.
These examples show the fields most clients build on directly.
{
"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"
}{
"panel_result_id": "pan_9y2m1q",
"panel_id": "nutrition_micronutrients",
"genome_id": "gen_test_nutrition_001",
"interpretation_version": "2026.05.1",
"summary": "This panel found user-specific nutrition and metabolic context with moderate evidence. It is suitable for an evidence summary card, not diagnosis or treatment advice.",
"sections": [
{
"title": "Metabolic Context",
"summary": "1 user-specific finding relevant to glucose handling.",
"interpretation": "For this user, TCF7L2 rs7903146 CT is relevant to glucose handling and diet-adjacent metabolic context.",
"evidence_level": "moderate",
"user_findings": [
{
"gene": "TCF7L2",
"variant_id": "rs7903146",
"user_result": "CT",
"interpretation": "The user carries one T allele at rs7903146, a common variant associated with glucose and type 2 diabetes risk in population studies.",
"relevance": "Useful as inherited metabolic context alongside diet, labs, history, and clinician review.",
"evidence_basis": "Moderate evidence based on GWAS Catalog and gnomAD."
}
]
}
],
"citations": [
{
"source": "GWAS Catalog",
"url": "https://www.ebi.ac.uk/gwas/",
"accessed_at": "2026-05-20"
},
{
"source": "gnomAD",
"url": "https://gnomad.broadinstitute.org/",
"accessed_at": "2026-05-20"
}
],
"limitations": [
"DNA does not measure current glucose, insulin sensitivity, diet, or symptoms.",
"This panel does not diagnose diabetes or recommend a nutrition protocol."
],
"clinical_boundary": "Use as inherited context for education and clinician review. Do not present as diagnosis, treatment, or dosing guidance."
}{
"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"
}
}{
"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"
}