CodeSystem Concept Lookup

Given a code/system, or a Coding, get additional details about the concept, including definition, status, designations, and properties. One of the products of this operation is a full decomposition of a code from a structure terminology

In Aidbox, this is essentially the same as search Concept by system and code

http
GET [base]/fhir/CodeSystem/$lookup?system=http://loinc.org&code=1963-8

equals to

http
GET [base]/Concept?system=http://loinc.org&code=1963-8

The only difference is the response format.

With Concept Search you can do even more than just getting one concept. For example, you can search and filter by any concept elements.

POST [base]/CodeSystem/$lookup

More info can be found in the official doc.

Parameters

Parameter Type Status
code code supported
system uri supported
version string supported
coding Coding supported
date dateTime not supported
displayLanguage code not supported
property code not supported

Examples

Available output parameters: name, display, version, designation, property

yaml
POST [base]/CodeSystem/$lookup
content-type: text/yaml

resourceType: Parameters
parameter:
- name: system
  valueUri: 'http://hl7.org/fhir/goal-status'
- name: coding
  valueCoding:
    code: accepted
yaml
resourceType: Parameters
parameter:
- name: display
  valueString: Accepted
- name: name
  valueString: GoalStatus
yaml
GET [base]/CodeSystem/$lookup?system=http://hl7.org/fhir/v2/0003&code=RAR

or:

yaml
POST [base]/CodeSystem/$lookup
content-type: text/yaml

resourceType: Parameters
parameter:
- name: system
  valueUri: 'http://hl7.org/fhir/v2/0003'
- name: code
  valueCode: RAR
yaml
resourceType: Parameters
parameter:
- name: display
  valueString: RAR - Pharmacy administration information query response
- name: designation
  value:
    display:
      de: Antwort bzgl. der Behandlungs-/Darreichungsform
      nl: RAR - Medicatietoediening-informatie query antwoord
- name: property
  value:
    v2-0003:
      deprecationDate: 2000-11
- name: name
  valueString: v2 Event Type