Code Prediction endpoint

Prediction of codes across many different systems are supported through a single REST endpoint request:

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

Pass your clinical context in the request body and receive a structured list of medical codes ready for 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 in one request

Notice 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." }
  ]
}

Next Steps

Coding Systems

Details on available systems and recommendations of pairings by use case.

Integration Guides

Learn how to combine code prediction with agents and client-side content to build coding workflows.

Codes and candidates

Learn more about the predict codes response message including two objects, codes and candidates.

Code filtering

Learn how to restrict 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.

Endpoints

Features

Coding Systems

Guides

Examples

Next Steps

Coding Systems

Integration Guides

Codes and candidates

Code filtering

​Examples

​Next Steps

Coding Systems

Integration Guides

Codes and candidates

Code filtering

Examples

Next Steps