Retrieve Medications for Subject Identifiers

get

/ohfapi/cg/v3.3/subjectapi/administeredmedications

This endpoint supports the retrieval of Medications for multiple Subject Identifiers passed. It returns all the Medication related information like Encounter, Administration Type, Dosage, Code, Outcome and other Medication associated information.

Request

Supported Media Types
Query Parameters
  • Collection Format: multi
    Minimum Number of Items: 1
    Maximum Number of Items: 2147483647
    Subject Identifiers
  • Pagination query params: ?limit=2&offset=0
  • Pagination query params: ?limit=2&offset=0
Security
Back to Top

Response

Supported Media Types

200 Response

successful operation
Body ()
Root Schema : PageableCollectionMedication
Type: object
Model for paginated collections of data.
Show Source
Nested Schema : items
Type: array
A collection of paged items.
Show Source
Nested Schema : Medication
Type: object
Model for a Patient medication object in CDM.
Show Source
Nested Schema : AdministrationType
Type: object
Show Source
Nested Schema : CodeableConcept
Type: object
Model that represents a value as a reference to one or more terminologies or ontologies or defined by the provision of text.
Show Source
Nested Schema : ValueQuantity
Type: object
Show Source
Nested Schema : DateRange
Type: object
Show Source
Nested Schema : Encounter
Type: object
Show Source
Nested Schema : Identifier
Type: object
Identifier assigned by a given system
Show Source
Nested Schema : LinkedReference
Type: object
Show Source
Nested Schema : Practitioner
Type: object
Model for a Practitioner, i.e. a person who is directly or indirectly involved in the provisioning of healthcare with a formal responsibility.
Show Source
Nested Schema : coding
Type: array
Read Only: true
Code(s) defined by a terminology system.
Show Source
Nested Schema : Coding
Type: object
Model for a reference to a code defined by a terminology system.
Show Source
Nested Schema : quantity
Type: array
Read Only: true
Show Source
Nested Schema : Quantity
Type: object
Model for a Quantity object in CDM.
Show Source
Nested Schema : CdmIdentifier
Type: object
Identifier assigned by a given system
Show Source
Nested Schema : Location
Type: object
Show Source
Nested Schema : Number
Type: object
Nested Schema : Address
Type: object
Model for a postal address.
Show Source
Nested Schema : HumanName
Type: object
Model for a name of a human with text and parts information.
Show Source
Nested Schema : Telecom
Type: object
Show Source
Nested Schema : line
Type: array
Street name, number, direction & P.O. Box etc.
Show Source
Nested Schema : given
Type: array
Given names (not always 'first'). Includes middle names.
Show Source

400 Response

Invalid parameters supplied

404 Response

medications not found
Back to Top

Examples

The following example submits a GET request.

API URL

http://localhost:7010/ohfapi/cg/v3.3/subjectapi/administeredmedications?limit=5&offset=0&id=1&id=2

Example of Response Body

The following example shows the contents of the response body in JSON format:

{  
   "resourceType":"MedicationAdministration",
   "items":[  
      {  
         "identifier":{  
            "system":"CDM",
            "value":"1"
         },
         "code":{  
            "coding":[  
               {  
                  "code":"1",
                  "display":"M1",
                  "description":"M1Desc",
                  "sysId":"RXNORM",
                  "sysName":"RXNORM",
                  "sysVersion":"RxNorm_full_10062014"
               }
            ]
         },
         "encounter":{  
            "identifier":{  
               "system":"CDM",
               "value":"ENC1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"1",
                     "display":"ENC_TYPE1",
                     "description":"ENC_TYPE_DESC1",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            },
            "location":{  
               "identifier":{  
                  "system":"CDM",
                  "value":"1"
               },
               "name":"FAC1",
               "type":{  
                  "coding":[  
                     {  
                        "code":"FAC_SUBTYP_RM",
                        "display":"Room",
                        "description":"A space allocated for a function within a building or a floor",
                        "sysId":"EHA_CUSTOM_CD_SYS",
                        "sysName":"EHA Custom Code System",
                        "sysVersion":"1"
                     }
                  ]
               }
            },
            "sequence":1
         },
         "administrationType":{  
            "value":"P"
         },
         "effectiveTimePeriod":{  
            "start":"01/01/1998",
            "end":"12/01/1998"
         },
         "dosage":{  
            "quantity":[  
               {  
                  "value":"50.1489",
                  "units":"cm",
                  "code":"1",
                  "description":"centi meter",
                  "sysId":"1",
                  "sysName":"UOM code",
                  "sysVersion":"UOM version"
               }
            ]
         },
         "outcome":{  
            "coding":[  
               {  
                  "code":"SUBADM_code1",
                  "display":"SUBADM_name_1",
                  "description":"SUBADM_desc_",
                  "sysId":"EHA_CUSTOM_CD_SYS",
                  "sysName":"EHA Custom Code System",
                  "sysVersion":"1"
               }
            ]
         },
         "practitioner":{  
            "identifier":{  
               "system":"CDM",
               "value":"SVCPRV1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"SVCPRV_TYP_CD_VALUE",
                     "display":"SVCPRV_TYP_CD_NAME",
                     "description":"SVCPRV_TYP_CD_DESC",
                     "sysId":"SVCPRV_TYP_CD_SYS",
                     "sysName":"Service Provider System",
                     "sysVersion":"2"
                  }
               ]
            },
            "speciality":{  
               "coding":[  
                  {  
                     "code":"Speciality_1",
                     "display":"SP_LTY_NAME",
                     "description":"SP_LTY_DESC",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            }
         },
         "subject":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1"
         },
         "patient":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1/patients"
         }
      },
      {  
         "identifier":{  
            "system":"CDM",
            "value":"2"
         },
         "code":{  
            "coding":[  
               {  
                  "code":"1",
                  "display":"M1",
                  "description":"M1Desc",
                  "sysId":"RXNORM",
                  "sysName":"RXNORM",
                  "sysVersion":"RxNorm_full_10062014"
               }
            ]
         },
         "encounter":{  
            "identifier":{  
               "system":"CDM",
               "value":"ENC1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"1",
                     "display":"ENC_TYPE1",
                     "description":"ENC_TYPE_DESC1",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            },
            "location":{  
               "identifier":{  
                  "system":"CDM",
                  "value":"1"
               },
               "name":"FAC1",
               "type":{  
                  "coding":[  
                     {  
                        "code":"FAC_SUBTYP_RM",
                        "display":"Room",
                        "description":"A space allocated for a function within a building or a floor",
                        "sysId":"EHA_CUSTOM_CD_SYS",
                        "sysName":"EHA Custom Code System",
                        "sysVersion":"1"
                     }
                  ]
               }
            },
            "sequence":2
         },
         "administrationType":{  
            "value":"P"
         },
         "effectiveTimePeriod":{  
            "start":"01/01/1998",
            "end":"12/01/1998"
         },
         "dosage":{  
            "quantity":[  
               {  
                  "value":"50.1489",
                  "units":"cm",
                  "code":"1",
                  "description":"centi meter",
                  "sysId":"1",
                  "sysName":"UOM code",
                  "sysVersion":"UOM version"
               }
            ]
         },
         "outcome":{  
            "coding":[  
               {  
                  "code":"SUBADM_code1",
                  "display":"SUBADM_name_1",
                  "description":"SUBADM_desc_",
                  "sysId":"EHA_CUSTOM_CD_SYS",
                  "sysName":"EHA Custom Code System",
                  "sysVersion":"1"
               }
            ]
         },
         "practitioner":{  
            "identifier":{  
               "system":"CDM",
               "value":"SVCPRV1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"SVCPRV_TYP_CD_VALUE",
                     "display":"SVCPRV_TYP_CD_NAME",
                     "description":"SVCPRV_TYP_CD_DESC",
                     "sysId":"SVCPRV_TYP_CD_SYS",
                     "sysName":"Service Provider System",
                     "sysVersion":"2"
                  }
               ]
            },
            "speciality":{  
               "coding":[  
                  {  
                     "code":"Speciality_1",
                     "display":"SP_LTY_NAME",
                     "description":"SP_LTY_DESC",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            }
         },
         "subject":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1"
         },
         "patient":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1/patients"
         }
      },
      {  
         "identifier":{  
            "system":"CDM",
            "value":"3"
         },
         "code":{  
            "coding":[  
               {  
                  "code":"1",
                  "display":"M1",
                  "description":"M1Desc",
                  "sysId":"RXNORM",
                  "sysName":"RXNORM",
                  "sysVersion":"RxNorm_full_10062014"
               }
            ]
         },
         "encounter":{  
            "identifier":{  
               "system":"CDM",
               "value":"ENC1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"1",
                     "display":"ENC_TYPE1",
                     "description":"ENC_TYPE_DESC1",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            },
            "location":{  
               "identifier":{  
                  "system":"CDM",
                  "value":"1"
               },
               "name":"FAC1",
               "type":{  
                  "coding":[  
                     {  
                        "code":"FAC_SUBTYP_RM",
                        "display":"Room",
                        "description":"A space allocated for a function within a building or a floor",
                        "sysId":"EHA_CUSTOM_CD_SYS",
                        "sysName":"EHA Custom Code System",
                        "sysVersion":"1"
                     }
                  ]
               }
            },
            "sequence":3
         },
         "administrationType":{  
            "value":"P"
         },
         "effectiveTimePeriod":{  
            "start":"01/01/1998",
            "end":"12/01/1998"
         },
         "dosage":{  
            "quantity":[  
               {  
                  "value":"50.1489",
                  "units":"cm",
                  "code":"1",
                  "description":"centi meter",
                  "sysId":"1",
                  "sysName":"UOM code",
                  "sysVersion":"UOM version"
               }
            ]
         },
         "outcome":{  
            "coding":[  
               {  
                  "code":"SUBADM_code1",
                  "display":"SUBADM_name_1",
                  "description":"SUBADM_desc_",
                  "sysId":"EHA_CUSTOM_CD_SYS",
                  "sysName":"EHA Custom Code System",
                  "sysVersion":"1"
               }
            ]
         },
         "practitioner":{  
            "identifier":{  
               "system":"CDM",
               "value":"SVCPRV1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"SVCPRV_TYP_CD_VALUE",
                     "display":"SVCPRV_TYP_CD_NAME",
                     "description":"SVCPRV_TYP_CD_DESC",
                     "sysId":"SVCPRV_TYP_CD_SYS",
                     "sysName":"Service Provider System",
                     "sysVersion":"2"
                  }
               ]
            },
            "speciality":{  
               "coding":[  
                  {  
                     "code":"Speciality_1",
                     "display":"SP_LTY_NAME",
                     "description":"SP_LTY_DESC",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            }
         },
         "subject":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1"
         },
         "patient":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1/patients"
         }
      },
      {  
         "identifier":{  
            "system":"CDM",
            "value":"4"
         },
         "code":{  
            "coding":[  
               {  
                  "code":"1",
                  "display":"M1",
                  "description":"M1Desc",
                  "sysId":"RXNORM",
                  "sysName":"RXNORM",
                  "sysVersion":"RxNorm_full_10062014"
               }
            ]
         },
         "encounter":{  
            "identifier":{  
               "system":"CDM",
               "value":"ENC1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"1",
                     "display":"ENC_TYPE1",
                     "description":"ENC_TYPE_DESC1",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            },
            "location":{  
               "identifier":{  
                  "system":"CDM",
                  "value":"1"
               },
               "name":"FAC1",
               "type":{  
                  "coding":[  
                     {  
                        "code":"FAC_SUBTYP_RM",
                        "display":"Room",
                        "description":"A space allocated for a function within a building or a floor",
                        "sysId":"EHA_CUSTOM_CD_SYS",
                        "sysName":"EHA Custom Code System",
                        "sysVersion":"1"
                     }
                  ]
               }
            },
            "sequence":4
         },
         "administrationType":{  
            "value":"P"
         },
         "effectiveTimePeriod":{  
            "start":"01/01/1998",
            "end":"12/01/1998"
         },
         "dosage":{  
            "quantity":[  
               {  
                  "value":"50.1489",
                  "units":"cm",
                  "code":"1",
                  "description":"centi meter",
                  "sysId":"1",
                  "sysName":"UOM code",
                  "sysVersion":"UOM version"
               }
            ]
         },
         "outcome":{  
            "coding":[  
               {  
                  "code":"SUBADM_code1",
                  "display":"SUBADM_name_1",
                  "description":"SUBADM_desc_",
                  "sysId":"EHA_CUSTOM_CD_SYS",
                  "sysName":"EHA Custom Code System",
                  "sysVersion":"1"
               }
            ]
         },
         "practitioner":{  
            "identifier":{  
               "system":"CDM",
               "value":"SVCPRV1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"SVCPRV_TYP_CD_VALUE",
                     "display":"SVCPRV_TYP_CD_NAME",
                     "description":"SVCPRV_TYP_CD_DESC",
                     "sysId":"SVCPRV_TYP_CD_SYS",
                     "sysName":"Service Provider System",
                     "sysVersion":"2"
                  }
               ]
            },
            "speciality":{  
               "coding":[  
                  {  
                     "code":"Speciality_1",
                     "display":"SP_LTY_NAME",
                     "description":"SP_LTY_DESC",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            }
         },
         "subject":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1"
         },
         "patient":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1/patients"
         }
      },
      {  
         "identifier":{  
            "system":"CDM",
            "value":"5"
         },
         "code":{  
            "coding":[  
               {  
                  "code":"1",
                  "display":"M1",
                  "description":"M1Desc",
                  "sysId":"RXNORM",
                  "sysName":"RXNORM",
                  "sysVersion":"RxNorm_full_10062014"
               }
            ]
         },
         "encounter":{  
            "identifier":{  
               "system":"CDM",
               "value":"ENC1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"1",
                     "display":"ENC_TYPE1",
                     "description":"ENC_TYPE_DESC1",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            },
            "location":{  
               "identifier":{  
                  "system":"CDM",
                  "value":"1"
               },
               "name":"FAC1",
               "type":{  
                  "coding":[  
                     {  
                        "code":"FAC_SUBTYP_RM",
                        "display":"Room",
                        "description":"A space allocated for a function within a building or a floor",
                        "sysId":"EHA_CUSTOM_CD_SYS",
                        "sysName":"EHA Custom Code System",
                        "sysVersion":"1"
                     }
                  ]
               }
            },
            "sequence":5
         },
         "administrationType":{  
            "value":"P"
         },
         "effectiveTimePeriod":{  
            "start":"01/01/1998",
            "end":"12/01/1998"
         },
         "dosage":{  
            "quantity":[  
               {  
                  "value":"50.1489",
                  "units":"cm",
                  "code":"1",
                  "description":"centi meter",
                  "sysId":"1",
                  "sysName":"UOM code",
                  "sysVersion":"UOM version"
               }
            ]
         },
         "outcome":{  
            "coding":[  
               {  
                  "code":"SUBADM_code1",
                  "display":"SUBADM_name_1",
                  "description":"SUBADM_desc_",
                  "sysId":"EHA_CUSTOM_CD_SYS",
                  "sysName":"EHA Custom Code System",
                  "sysVersion":"1"
               }
            ]
         },
         "practitioner":{  
            "identifier":{  
               "system":"CDM",
               "value":"SVCPRV1"
            },
            "type":{  
               "coding":[  
                  {  
                     "code":"SVCPRV_TYP_CD_VALUE",
                     "display":"SVCPRV_TYP_CD_NAME",
                     "description":"SVCPRV_TYP_CD_DESC",
                     "sysId":"SVCPRV_TYP_CD_SYS",
                     "sysName":"Service Provider System",
                     "sysVersion":"2"
                  }
               ]
            },
            "speciality":{  
               "coding":[  
                  {  
                     "code":"Speciality_1",
                     "display":"SP_LTY_NAME",
                     "description":"SP_LTY_DESC",
                     "sysId":"EHA_CUSTOM_CD_SYS",
                     "sysName":"EHA Custom Code System",
                     "sysVersion":"1"
                  }
               ]
            }
         },
         "subject":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1"
         },
         "patient":{  
            "reference":"/ohfapi/cg/v3.3/subjectapi/subjects/1/patients"
         }
      }
   ],
   "count":5,
   "hasMore":true,
   "links":[  
      {  
         "rel":"self",
         "href":"http://localhost:7010/ohfapi/cg/v3.3/subjectapi/administeredmedications?limit=5&offset=0&id=1&id=2"
      },
      {  
         "rel":"next",
         "href":"http://localhost:7010/ohfapi/cg/v3.3/subjectapi/administeredmedications?offset=5&limit=5&id=1&id=2"
      }
   ]
}
Back to Top