Search Facets
Retrieve search facets for filtering medical terminology search results by vocabulary, domain, concept class, and standard concept status.
Overview
This endpoint provides faceted search capabilities for medical terminology, returning aggregated counts that can be used to filter and refine search results. Facets help users understand the distribution of concepts across different dimensions.Query Parameters
Search query to generate facets for. When provided, facets reflect the distribution of matching concepts.
Filter facets to specific vocabularies (comma-separated)
Examples:
Examples:
SNOMED, ICD10CM,LOINC, RXNORMSpecific vocabulary release version (defaults to latest)
Examples:
Examples:
2025.1, 2024.2Response
Indicates if the request was successful
Contains the faceted search results
Response metadata
Usage Examples
Get Facets for a Search Query
Filter Facets by Vocabulary
General Facets Without Query
Get overall distribution of concepts:Facet Types
Vocabularies
Shows distribution across medical vocabularies (SNOMED, ICD10CM, LOINC, RxNorm, etc.). Use to filter searches to specific terminology systems.Domains
Shows distribution across clinical domains (Condition, Drug, Procedure, Measurement, etc.). Use to focus on specific types of medical concepts.Concept Classes
Shows distribution across concept classifications (Clinical Finding, Disorder, Ingredient, etc.). Provides more granular filtering than domains.Standard Concepts
Shows distribution by OMOP standard concept status:- S (Standard): Preferred concepts for OMOP CDM analytics
- C (Classification): Classification concepts for grouping
- N (Non-standard): Source concepts that map to standard concepts
Related Endpoints
- Basic Search - Apply facet filters to search
- Advanced Search - Complex search with multiple filters