ConceptMap search

const options = {method: 'GET'};

fetch('https://fhir.omophub.com/fhir/{version}/ConceptMap', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "fullUrl": "https://fhir.omophub.com/fhir/r4/ConceptMap/GenderClass",
      "resource": {
        "resourceType": "ConceptMap",
        "id": "GenderClass",
        "url": "http://hl7.org/fhir/uv/omop/ConceptMap/GenderClass",
        "version": "1.0.0",
        "status": "active",
        "group": [
          {
            "source": "http://hl7.org/fhir/administrative-gender",
            "target": "https://fhir-terminology.ohdsi.org",
            "element": [
              {
                "code": "male",
                "target": [
                  {
                    "code": "8507",
                    "display": "Male",
                    "equivalence": "equivalent"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

ConceptMap search

const options = {method: 'GET'};

fetch('https://fhir.omophub.com/fhir/{version}/ConceptMap', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "fullUrl": "https://fhir.omophub.com/fhir/r4/ConceptMap/GenderClass",
      "resource": {
        "resourceType": "ConceptMap",
        "id": "GenderClass",
        "url": "http://hl7.org/fhir/uv/omop/ConceptMap/GenderClass",
        "version": "1.0.0",
        "status": "active",
        "group": [
          {
            "source": "http://hl7.org/fhir/administrative-gender",
            "target": "https://fhir-terminology.ohdsi.org",
            "element": [
              {
                "code": "male",
                "target": [
                  {
                    "code": "8507",
                    "display": "Male",
                    "equivalence": "equivalent"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

Overview

GET /fhir/{version}/ConceptMap returns the HL7 FHIR-to-OMOP Implementation Guide ConceptMaps that OMOPHub hosts - gender, encounter class/admit-source/discharge-disposition, condition status, allergy/intolerance categories, immunization route/source, vital signs, blood pressure, vaccine, and clinical-findings maps. These back the $translate url parameter (see $translate) and let IG-driven tooling discover the maps by canonical URL.

Targets use FHIR R4 equivalence on /fhir/r4/ and /fhir/r4b/, and the R5 relationship code on /fhir/r5/ and /fhir/r6/.

Contract Parameters

string

default:"r4"

string

OMOP vocabulary release; defaults to the active release.

string

Header alternative to vocab_release; the header takes precedence.

FHIR wire version (r4, r4b, r5, or r6).

string

Canonical ConceptMap URL. Omit it to list all hosted maps.

Request

List all IG ConceptMaps

curl "https://fhir.omophub.com/fhir/r4/ConceptMap" \
  -H "Authorization: Bearer oh_your_api_key"

Filter by canonical URL

curl "https://fhir.omophub.com/fhir/r4/ConceptMap?url=http://hl7.org/fhir/uv/omop/ConceptMap/GenderClass" \
  -H "Authorization: Bearer oh_your_api_key"

Response

A FHIR searchset Bundle. With no url, every hosted ConceptMap is returned; with a url, a single-entry Bundle (or an empty Bundle, total: 0, for an unknown URL, per FHIR search semantics).

Response Fields

string

Always Bundle.

string

Always searchset.

integer

Number of matching maps.

array

ConceptMap matches.

string

Absolute map URL.

object

ConceptMap resource with identity, status, and mapping groups.

array

Source-to-target groups.

array

Source codes and their targets.

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "fullUrl": "https://fhir.omophub.com/fhir/r4/ConceptMap/GenderClass",
      "resource": {
        "resourceType": "ConceptMap",
        "id": "GenderClass",
        "url": "http://hl7.org/fhir/uv/omop/ConceptMap/GenderClass",
        "version": "1.0.0",
        "status": "active",
        "group": [
          {
            "source": "http://hl7.org/fhir/administrative-gender",
            "target": "https://fhir-terminology.ohdsi.org",
            "element": [
              {
                "code": "male",
                "target": [
                  {
                    "code": "8507",
                    "display": "Male",
                    "equivalence": "equivalent"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

FHIR Terminology Service

ConceptMap search

Overview

Contract Parameters

Request

Response

Response Fields

See also

​Overview

​Contract Parameters

​Request

​Response

​Response Fields

​See also

Overview

Contract Parameters

Request

Response

Response Fields

See also