Get a specific code

GET/construe/codes/{codesystem}/{codeID}

Looks up a specific code and returns its details.

Usage of CPT is subject to AMA requirements: see PhenoML Terms of Service.

RequiresBearerauthentication

Path parameters

codesystemstringrequired

Code system name

codeIDstringrequired

The code identifier. ICD-10-CM codes are stored without their cosmetic dot (use "E1165", not "E11.65").

Query parameters

versionstringoptional

Specific version of the code system, such as umls-2026aa.

Returns

Code details

Response fields

systemobjectrequired

namestringrequired

Code system name

versionstringrequired

Code system version

codestringrequired

The code identifier

descriptionstringrequired

Short description of the code

definitionstringoptional

Extended definition of the code (if available)

GETRequest

# 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 GET "https://experiment.app.pheno.ml/construe/codes/ICD-10-CM/E1165" \
  -H "Authorization: Bearer $PHENOML_TOKEN"

200 OKExample Response

{
  "system": {
    "name": "ICD-10-CM",
    "version": "2025"
  },
  "code": "E1165",
  "description": "Type 2 diabetes mellitus with hyperglycemia"
}