Get code system detail

GET/construe/codes/systems/{codesystem}

Returns full metadata for a single code system, including timestamps and builtin status.

RequiresBearerauthentication

Path parameters

codesystemstringrequired

Code system name (e.g., "ICD-10-CM", "SNOMED_CT_US_LITE")

Query parameters

versionstringoptional

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

Returns

Code system detail

Response fields

namestringrequired

Code system name

versionstringrequired

Code system version

code_countintegerrequired

Total number of codes in the system

builtinbooleanrequired

Whether this is a built-in system (vs custom uploaded)

statusstringrequired

Processing status of the code system.

"processing": embeddings are being generated
"ready": code system is ready for use
"failed": processing failed (re-upload with replace=true to retry)

processingreadyfailed

created_atstring (date-time)required

When the code system was created

updated_atstring (date-time)required

When the code system was last updated

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/systems/ICD-10-CM?version=2025" \
  -H "Authorization: Bearer $PHENOML_TOKEN"

200 OKExample Response

{
  "name": "ICD-10-CM",
  "version": "2025",
  "code_count": 97584,
  "builtin": true,
  "status": "ready",
  "created_at": "2026-02-10T18:33:23Z",
  "updated_at": "2026-02-10T18:33:23Z"
}