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. Required if multiple versions exist.

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

curl 'https://experiment.app.pheno.ml/construe/codes/systems/ICD-10-CM?version=2025' \
  -H 'Authorization: Bearer YOUR_API_KEY'

200 OKResponse

{
  "name": "ICD-10-CM",
  "version": "2025",
  "code_count": 72750,
  "builtin": true,
  "status": "ready",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}