Terminology server text search

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.

Path Params
string
required

Code system name

Query Params
string
required
length ≤ 500

Search query (searches code IDs and descriptions)

string

Specific version of the code system

integer
≤ 100
Defaults to 20

Maximum number of results (default 20, max 100)

Responses

400

Invalid parameters or missing query

401

Unauthorized

404

Code system not found

500

Server error

501

Text search not configured

Language
Credentials
Bearer
JWT
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json