Overview
Retrieve mappings from a concept to equivalent or related concepts in other vocabulary systems.Path Parameters
integer
required
The OMOP concept ID to get mappings for
Query Parameters
string
Filter mappings to a specific target vocabulary (e.g., “ICD10CM”, “SNOMED”)
string
Comma-separated relationship types to return. Defaults to
Maps to.Use Maps to,Maps to value to include the Value-as-Concept decomposition of
composite concepts. Like include_invalid, this parameter was accepted but
not applied before 2026-08-11.integer
default:"1"
Page number, 1-based
integer
default:"100"
Mappings per page. Values above 200 are clamped to 200 without an error, so
requesting more returns a smaller page than asked for.
boolean
default:"true"
Include mappings whose relationship or target concept is deprecated. Defaults
to
true - pass false to return only currently-valid mappings.The source concept itself is never filtered, so a deprecated concept still
returns what it maps to.string
Specific vocabulary release version to use (e.g., “2025.1”, “2024.2”). When
not specified, uses the default/latest vocabulary version.
Response
boolean
Indicates if the request was successful
object
Contains the mapping results
object
Response metadata
Examples
Related Endpoints
- Map Concepts - Map multiple concepts to a target vocabulary
- Batch Map Concepts - Batch mapping operations