Phenoml Logo

Text search (keyword-based)

GET/construe/codes/{codesystem}/search/text

Performs fast full-text search over code IDs and descriptions.

Availability: This endpoint is only available for built-in code systems. Custom code systems uploaded via /construe/upload are not indexed for full-text search and will return empty results. Use /search/semantic to search custom code systems.

When to use: Best for autocomplete UIs, code lookup, or when users know part of the code ID or specific keywords. Fast response times suitable for typeahead interfaces.

Features:

  • Substring matching on code IDs (e.g., "11.65" finds "E11.65")
  • Typo tolerance on descriptions (not on code IDs)
  • Fast response times (~10-50ms)

Examples:

  • Query "E11" finds all codes starting with E11 (diabetes codes)
  • Query "diabtes" (typo) still finds "diabetes" codes

Trade-offs: Faster than semantic search, but only matches keywords/substrings. Won't find conceptually related codes with different terminology.

See also: /search/semantic for finding conceptually similar codes.

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

Find a code by its identifier

Input
codesystempathICD-10-CM
qqueryE11.65
limitquery5
Result
found: 3
E11.65Type 2 diabetes mellitus with hyperglycemia
E11.649Type 2 diabetes mellitus with hypoglycemia without coma
E11.69Type 2 diabetes mellitus with other specified complication
Terms of Service|Privacy Policy