List codes in a code system

GET/construe/codes/{codesystem}

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

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

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

200 OKResponse

{
  "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
}