# Form-fill API Reference

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.emtelligent.com/formfill/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.17-1**.

Fill FHIR R4 Questionnaires, or answer free-form questions, from clinical documents.

Jobs are asynchronous: submit with `POST /v1/jobs`, then poll `GET /v1/jobs/{id}` or receive the
`job.finished` webhook, then fetch the result **once** with `GET /v1/jobs/{id}/result`. Nothing is
kept beyond 24 hours. Authenticate with `Authorization: Bearer <API key or OAuth access token>`;
keys need the `formfill:process` scope. Every error has the body
`{"error": {"code", "message", "request_id"}}`.


## API Docs

- [Job finished](https://docs.emtelligent.com/formfill/api/webhooks/job-finishedjob-finished-post.md): Form-fill API Reference > Webhooks
- [Submit a job](https://docs.emtelligent.com/formfill/api/jobs/submit-job-v-1-jobs-post.md): Form-fill API Reference > jobs
- [Get job status](https://docs.emtelligent.com/formfill/api/jobs/get-job-v-1-jobs-job-id-get.md): Form-fill API Reference > jobs
- [Cancel a job or purge its result](https://docs.emtelligent.com/formfill/api/jobs/delete-job-v-1-jobs-job-id-delete.md): Form-fill API Reference > jobs
- [Get the result (once)](https://docs.emtelligent.com/formfill/api/jobs/get-result-v-1-jobs-job-id-result-get.md): Form-fill API Reference > jobs

## 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