Phenoml · Documentation

Read the spec.
Ship the integration.

Guides, references, and tools for turning clinical text into structured, interoperable healthcare data.

API v1.084 endpoints · 11 servicesHIPAA-eligible · BAA

Get started Explore the API

Start here

01Quickstart 02Authentication 03Extract codes you can trust

API credentials

Get started

Understand clinical text

Extract codes you can trust Bring your own terminology Search medical terminologies

Structure and store

From clinical text to a populated EHR Summaries & patient summaries Connect an EHR

Act on it

Build a clinical agent Automate a repeatable process Build patient cohorts

Try it out

Explore representative requests and responses from the API reference. These static examples use the shared sandbox and require an access token from the authentication guide—this page never sends a request.

Construe pulls ICD-10-CM codes from a clinical sentence, each with a citation.

POST/construe/extractExample request

curl -X POST "https://experiment.app.pheno.ml/construe/extract" \
  -H "Authorization: Bearer $PHENOML_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Patient reports chest pain and shortness of breath.",
    "system": { "name": "ICD-10-CM", "version": "2025" }
  }'

200 OKExample response

{
  "codes": [
    { "code": "R07.9", "description": "Chest pain, unspecified", "valid": true },
    { "code": "R06.02", "description": "Shortness of breath", "valid": true }
  ]
}

Open in the API reference

Browse by product