Overview

The Prep API turns large, messy clinical document bundles into cleanly split, classified, and NLP-ready documents. It is built on the emtelligent OCR engine and designed for the complex faxed and electronically transmitted chart bundles and APS reports common in medicine today.

A single multi-hundred-page fax or chart bundle becomes a set of discrete, individually addressable documents — each with a document-type classification, its extracted metadata, and its full extracted text.

Capabilities

The Prep API is modular. You select any combination of the following functions.

FunctionWhat it does
OCRFull-text extraction using the emtelligent OCR engine, so scanned, faxed, and image-based pages become machine-readable text — with the same layout awareness and complex-table handling as the standalone OCR API.
Document splittingAutomatically detects document boundaries inside a bundle and separates it into its individual constituent documents.
Document classificationCategorizes each split document against a document-type ontology based on a modified version of the LOINC document ontology, ensuring consistency in document classification.
Metadata extraction and pagewise summarizationPulls structured metadata from each document and produces per-page summaries.
NLP API preparationOptionally assembles the split and OCR’d output into an NLP-ready .jsonl feed, so Prep output flows directly into the emtelligent NLP API with no additional glue code.

Input and output

Input — PDF and TIFF, including large multi-page bundles.

Output — for each document detected in a bundle: its document-type classification, its extracted metadata, and its full extracted text, delivered together as one structured result. When requested, the whole bundle is also emitted as a single NLP-ready .jsonl feed.

How a job works

The Prep API is asynchronous and reads from and writes to cloud object storage that you control. You grant it scoped access to an input bucket and an output bucket, then submit jobs that reference objects in the input bucket by key.

1

Submit

Submit a job describing the objects to process, the functions to run, and the buckets to read from and write to. The response returns a job identifier.

2

Poll for status

Poll the job status using that identifier until the job reaches a terminal state.

3

Collect results

Read the structured results from your output bucket, under the output prefix you supplied.

A job can be cancelled while it is still in flight. Requests authenticate with either an API key or a JWT.

Ways to use it

Using Prep with the other APIs

Prep can be used on its own, and it uses the OCR API internally, so you do not need to call OCR separately to process scanned or faxed pages. Prep is also used by the Extract API, which orchestrates Prep and the NLP API through managed pipelines.

If your goal is structured clinical data rather than prepared documents, the Extract API will do that in one call. Use Prep directly when you need the split and classified documents themselves, or want control over the individual stages.