POST api/emar/clients/{clientId}/administer-medication
Records the administration of an eMAR medication to a Client
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| clientId |
the Id of the client to whom the administered medication will be recorded. |
integer |
Required |
Body Parameters
An object with input parameters.
AdministerMedicationInput| Name | Description | Type | Additional information |
|---|---|---|---|
| MedicationScheduleId | integer |
None. |
|
| MedicationScheduleDataId | integer |
None. |
|
| DispensedOnUtc | date |
None. |
|
| PatientResponse | string |
None. |
|
| RefusalReason | string |
None. |
|
| QtyAdministered | decimal number |
None. |
|
| AdministrationNotes | string |
None. |
|
| InjectionSite | string |
None. |
|
| CountCurrent | decimal number |
None. |
|
| eMarPillBoxId | integer |
None. |
|
| IsPrn | boolean |
None. |
|
| EmarVersion | EmarVersion |
None. |
Request Formats
application/json, text/json
Sample:
{
"MedicationScheduleId": 1,
"MedicationScheduleDataId": 1,
"DispensedOnUtc": "2026-05-05T07:17:38.9743065-04:00",
"PatientResponse": "sample string 1",
"RefusalReason": "sample string 2",
"QtyAdministered": 1.0,
"AdministrationNotes": "sample string 3",
"InjectionSite": "sample string 4",
"CountCurrent": 1.0,
"eMarPillBoxId": 1,
"IsPrn": true,
"EmarVersion": 0
}
application/xml, text/xml
Sample:
<AdministerMedicationInput xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CWI.Mobile.Domain.DTO.ActionInputs"> <AdministrationNotes>sample string 3</AdministrationNotes> <CountCurrent>1</CountCurrent> <DispensedOnUtc>2026-05-05T07:17:38.9743065-04:00</DispensedOnUtc> <EmarVersion>NotSet</EmarVersion> <InjectionSite>sample string 4</InjectionSite> <IsPrn>true</IsPrn> <MedicationScheduleDataId>1</MedicationScheduleDataId> <MedicationScheduleId>1</MedicationScheduleId> <PatientResponse>sample string 1</PatientResponse> <QtyAdministered>1</QtyAdministered> <RefusalReason>sample string 2</RefusalReason> <eMarPillBoxId>1</eMarPillBoxId> </AdministerMedicationInput>
application/x-www-form-urlencoded
Sample:
Response Information
Resource Description
An Http response message with the following status codes: 200 = success (includes an object with the MedicationScheduleId of the administered medication), 400 = bad request (the request is malformed or with invalid data), 404 = not found (this is returned when the supplied client Id can't be found.) 500 = something went wrong (the request was not processed).
integerResponse Formats
application/json, text/json
Sample:
1
application/xml, text/xml
Sample:
<int xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1</int>