# Synth API Reference

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.emtelligent.com/synth/api/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emtelligent.com/_mcp/server.

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"}}`.


## API Docs

- [List jobs](https://docs.emtelligent.com/synth/api/jobs/list-jobs-v-1-jobs-get.md): Synth API Reference > Jobs
- [Submit a job](https://docs.emtelligent.com/synth/api/jobs/submit-job-v-1-jobs-post.md): Synth API Reference > Jobs
- [Get a job](https://docs.emtelligent.com/synth/api/jobs/get-job-v-1-jobs-job-id-get.md): Synth API Reference > Jobs
- [Cancel a job](https://docs.emtelligent.com/synth/api/jobs/cancel-job-v-1-jobs-job-id-delete.md): Synth API Reference > Jobs
- [Download a result](https://docs.emtelligent.com/synth/api/jobs/download-result-v-1-jobs-job-id-results-name-get.md): Synth API Reference > Jobs
- [List cohorts](https://docs.emtelligent.com/synth/api/cohorts/list-cohorts-v-1-cohorts-get.md): Synth API Reference > Cohorts
- [Submit a cohort](https://docs.emtelligent.com/synth/api/cohorts/submit-cohort-v-1-cohorts-post.md): Synth API Reference > Cohorts
- [Get a cohort](https://docs.emtelligent.com/synth/api/cohorts/get-cohort-v-1-cohorts-cohort-id-get.md): Synth API Reference > Cohorts
- [Cancel a cohort](https://docs.emtelligent.com/synth/api/cohorts/cancel-cohort-v-1-cohorts-cohort-id-delete.md): Synth API Reference > Cohorts
- [Download a cohort result](https://docs.emtelligent.com/synth/api/cohorts/download-cohort-result-v-1-cohorts-cohort-id-results-name-get.md): Synth API Reference > Cohorts

## OpenAPI Specification

- [OpenAPI JSON](https://docs.emtelligent.com/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format
- [OpenAPI YAML](https://docs.emtelligent.com/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format