Path Parameters
The unique identifier of the concept to retrieve mappings for
Example:
Example:
201826
(Type 2 diabetes mellitus in SNOMED)Query Parameters
Filter mappings to specific target vocabularies
Example:
Example:
ICD10CM,ICD10,HCPCS
Filter by specific mapping relationship types
Default:
Example:
Default:
Maps to,Mapped from
Example:
Maps to,Maps to value
Direction of mappings to retrieve
Options:
Options:
outgoing
, incoming
, both
Include indirect mappings (concept → intermediate → target)
Only return mappings to standard concepts
Include mapping quality scores and confidence ratings
Include synonym information for mapped concepts
Include contextual information about mapping relationships
Only include mappings to active concepts
Sort mappings by specified field
Options:
Options:
vocabulary_id
, concept_name
, mapping_quality
Sort order for mappings
Options:
Options:
asc
, desc
Number of mappings to return per page (max 500)
Page number for pagination (1-based)
Response
Information about the source concept for which mappings were retrieved
Array of mapping relationships to other vocabularies
Summary statistics about the mappings
Response metadata and pagination information
Usage Examples
Basic Concept Mappings
Get all mappings for a concept:ICD-10 Mappings Only
Get mappings to specific vocabularies:High-Quality Mappings
Get mappings with quality information:Outgoing Mappings Only
Get only outgoing mappings from the concept:Comprehensive Mapping Analysis
Get detailed mapping information with context:Related Endpoints
- Get Mapping Coverage - Mapping coverage analysis
- Get Vocabulary Mappings - All mappings between vocabularies
- Get Concept Details - Complete concept information
- Search Concepts - Find concepts across vocabularies
Notes
- Mappings enable interoperability between different medical coding systems
- “Maps to” relationships typically go from non-standard to standard concepts
- Quality scores help identify the most reliable mappings for clinical use
- Some mappings may be contextual (e.g., billing vs. clinical use)
- Indirect mappings provide pathways through intermediate vocabularies
- Geographic scope indicates where mappings are officially recognized
- Validation status shows the review and approval status of mappings
- Standard concepts are preferred targets for most mapping applications