How it works

Code prediction happens through a single endpoint:

POST https://api.$environment.corti.app/v2/tools/coding/

Pass your clinical context in the request body and get back structured medical codes — ready for clinician review.

Choose one or more coding systems

Set system to an array of one or more system identifiers. Systems are typically combined by encounter type — for example, icd10cm-outpatient + cpt for office visits and ED encounters, or icd10cm-inpatient + icd10pcs for hospital admissions. See Coding Systems for the full list.

Pass your clinical context

The context field is an array of context objects. Two input types are supported:

Text — type: "text" with the clinical text in text. Pass multiple objects to provide multiple context sources.
Document — type: "documentId" with a document ID in documentId, referencing a document already stored in Corti.

Read the response

codes contains the medical entities the model predicts should be coded. candidates contains entities that are clinically relevant but not strictly required — optional codes surfaced for human review. usageInfo.creditsConsumed reports the credits used for the request, which is reflected in your account billing.

Examples

A request against a single coding system:

{
  "system": ["icd10cm-outpatient"],
  "context": [
    { "type": "text", "text": "Patient presents with acute otitis media of the right ear." }
  ]
}

A request against multiple coding systems at once — the response includes codes from all requested systems in the same codes array, each tagged with its system value:

{
  "system": ["icd10cm-outpatient", "cpt"],
  "context": [
    { "type": "text", "text": "Patient presents with acute otitis media of the right ear." }
  ]
}

See Coding Systems for recommended pairings by encounter type.

See Advanced Usage to restrict which codes the model may predict using the filter field.

Please contact us if you need help getting started or run into issues with your first request.

Code Prediction

Coding Systems

Use Cases

Examples

​Examples

Examples