Phenoml · Documentation

Read the spec.
Ship the integration.

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

API v1.098 endpoints · 11 servicesHIPAA compliant · SOC 2 Type II

Get started Explore the API

Start here

01Authentication 02Extract 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 requests and responses from the current OpenAPI spec. Examples use the shared sandbox; set PHENOML_CLIENT_ID and PHENOML_CLIENT_SECRET from the authentication guide to run them. This page never sends a request.

Turn clinical text into medical codes.

POST/construe/extractExample request

# Get authentication token
PHENOML_TOKEN=$(curl -X POST "https://experiment.app.pheno.ml/v2/auth/token" \
  -u "$PHENOML_CLIENT_ID:$PHENOML_CLIENT_SECRET" \
  | jq -r '.access_token')

curl -X POST "https://experiment.app.pheno.ml/construe/extract" \
  -H "Authorization: Bearer $PHENOML_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "Patient is a 14-year-old female, previously healthy, who is here for evaluation of abnormal renal ultrasound with atrophic right kidney.",
  "system": {
    "name": "ICD-10-CM",
    "version": "2025"
  }
}'

200Example response

{
  "system": {
    "name": "ICD-10-CM",
    "version": "2025"
  },
  "codes": [
    {
      "code": "Q60.3",
      "description": "Renal hypoplasia, unspecified",
      "valid": true
    },
    {
      "code": "R93.42",
      "description": "Abnormal findings on diagnostic imaging of kidney",
      "valid": true
    },
    {
      "code": "N28.1",
      "description": "Cyst of kidney, acquired",
      "valid": true
    }
  ]
}

Open in the API reference

Browse by product