Synth API Reference

The published specification is version 2026.10.31-1.

Generate realistic synthetic patients: a coded record, a FHIR R4 bundle, and clinical documents, one patient at a time (jobs) or many in a shared health system (cohorts).

Jobs and cohorts are asynchronous: submit with POST /v1/jobs or POST /v1/cohorts, poll GET /v1/jobs/{job_id} or GET /v1/cohorts/{cohort_id} until the status is succeeded, then download each result once within 24 hours. Authenticate with Authorization: Bearer <API key or OAuth access token>; keys need the synth:process scope. Send an Idempotency-Key with each submission to make it safe to retry. Every error has the body {"error": {"code", "message", "request_id"}}.