Skip to main content

Overview

Retrieve mappings from a concept to equivalent or related concepts in other vocabulary systems. Each row carries the target’s target_domain_id and target_standard_concept, so a single call is enough both to route the mapping to the right CDM table and to verify that a Maps to target is standard. Neither previously required a second request per target; before 2026-09-09 the response omitted both fields and each one did.
The row shape matches POST /v1/concepts/map field for field, plus target_domain_id, target_standard_concept. Use this endpoint for one concept, map for up to 100.
OMOP vocabulary releases do not provide a measured probability or confidence for each mapping, so this endpoint does not publish a confidence score. Use relationship_id, mapping_type, invalid_reason, and target_standard_concept to interpret and validate each mapping.

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.Note that POST /v1/concepts/map defaults this to false. The two differ deliberately: this endpoint lists what exists for one concept, where hiding deprecated mappings would misrepresent the record, while map resolves sources for downstream use. Pass the parameter explicitly on both if you need them to agree.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