Skip to main content

Overview

This endpoint provides bounded autocomplete suggestions as users type. It uses prefix matching with a fuzzy fallback for longer queries and supports vocabulary and domain filters. Autocomplete is not a paginated search endpoint. Use page_size to bound the suggestion list; page and algorithm are not supported. Use Basic Search when you need pagination.

Query Parameters

string
required
Search query for autocompletion (minimum 2 characters, maximum 100)
string
Filter suggestions to specific vocabularies (comma-separated)
Examples: SNOMED, ICD10CM,LOINC, RxNorm
string
Filter suggestions to specific domains (comma-separated)
Examples: Condition, Drug,Procedure
integer
default:"10"
Maximum number of suggestions to return (1-20)
string
Specific vocabulary release version (defaults to latest)

Response

boolean
Whether autocomplete completed.
string
The submitted query.
array
Compact suggestion records containing suggestion, type, and count.
integer
Maximum number of suggestions requested.
Search metadata including the query, returned count, and applied filters.

Usage Examples

Basic Autocomplete

Get suggestions for a partial query:

Vocabulary-Filtered Autocomplete

Focus suggestions on specific vocabularies:

Domain-Filtered Autocomplete

Get suggestions only for specific domains:

Performance Notes

  • Minimum query length: 2 characters required
  • Response time: Optimized for real-time use (<100ms typical)
  • Caching: Results are cached for 24 hours per vocabulary release
  • Rate limiting: Standard rate limits apply