Skip to main content

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