> For the complete documentation index, see [llms.txt](https://docs.b2ihealthcare.com/snow-owl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2ihealthcare.com/snow-owl/8.x/index-3/index-3/conceptmaps.md).

# ConceptMap

### ConceptMap API

The endpoints `/ConceptMap` and `/ConceptMap/{conceptMapId}` and corresponding operations expose the following types of terminology resources:

* SNOMED CT Simple Map Reference Sets with Concepts as referenced components
* SNOMED CT Complex Map Reference Sets
* SNOMED CT Extended Map Reference Sets
* Snow Owl's generic Concept Maps

### $translate

All concept map accessible via the `/ConceptMap` endpoints are considered when retrieving mappings (*translations*). The translate request's *source* that designates the source value set cannot be interpreted hence not used. With the exception of SNOMED CT where the standard URI is expected, our proprietary *short name* or *component ids* are used to designate the source/target code system.

SNOMED CT:

* Simple Map Type Reference Set mappings are considered *equivalent* in terms of their correlation
* The availability and format of target code systems are not guaranteed, there is an ongoing conversation at SNOMED CT International to rectify this.