# Summarization API Reference

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

Summarize clinical documents, following your instructions. Send a document's text — or several documents about one patient, including output from the Prep and NLP APIs — and a prompt describing the summary you want: who it is for, what to cover, how long. You get one summary, as Markdown. With several documents, the summary cites them.

Jobs are asynchronous: submit with `POST /v1/jobs`, poll `GET /v1/jobs/{id}`, then fetch the result **once** with `GET /v1/jobs/{id}/result`. Nothing is kept beyond 24 hours. Send an `Idempotency-Key` header to make submissions safe to retry.

Authenticate with `Authorization: Bearer <API key or OAuth access token>`; keys need the `summarization:process` scope. Every error has the body `{"error": {"code", "message", "request_id"}}`.


## API Docs

- [Submit documents](https://docs.emtelligent.com/summarization/api/jobs/submit-job-v-1-jobs-post.md): Summarization API Reference > jobs
- [Get job status](https://docs.emtelligent.com/summarization/api/jobs/get-job-v-1-jobs-job-id-get.md): Summarization API Reference > jobs
- [Cancel a job or purge its result](https://docs.emtelligent.com/summarization/api/jobs/delete-job-v-1-jobs-job-id-delete.md): Summarization API Reference > jobs
- [Get the summary (once)](https://docs.emtelligent.com/summarization/api/jobs/get-result-v-1-jobs-job-id-result-get.md): Summarization 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