List codes in a code system

GET/construe/codes/{codesystem}

Returns a paginated list of all codes in the specified code system.

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

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.

cursorstringoptional

Pagination cursor from previous response

limitintegeroptionaldefault 20

Maximum number of codes to return (default 20)

Returns

Paginated list of codes

Response fields

systemobjectrequired

namestringrequired

Code system name

versionstringrequired

Code system version

codesobject[]required

codestringrequired

The code identifier

descriptionstringrequired

Short description of the code

definitionstringoptional

Extended definition of the code (if available)

next_cursorstringoptional

Cursor for fetching the next page (null if no more results)

has_morebooleanrequired

Whether there are more results 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?version=2025&limit=5" \
  -H "Authorization: Bearer $PHENOML_TOKEN"

200 OKExample Response

{
  "system": {
    "name": "ICD-10-CM",
    "version": "2025"
  },
  "codes": [
    {
      "code": "A00",
      "description": "Cholera"
    },
    {
      "code": "A000",
      "description": "Cholera due to Vibrio cholerae 01, biovar cholerae"
    },
    {
      "code": "A001",
      "description": "Cholera due to Vibrio cholerae 01, biovar eltor"
    },
    {
      "code": "A009",
      "description": "Cholera, unspecified"
    },
    {
      "code": "A01",
      "description": "Typhoid and paratyphoid fevers"
    }
  ],
  "next_cursor": "QTAx",
  "has_more": true
}