POST api/emar/clients/{clientId}/administer-medication

Records the administration of an eMAR medication to a Client

Request Information

URI Parameters

NameDescriptionTypeAdditional 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
NameDescriptionTypeAdditional 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:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'AdministerMedicationInput'.

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).

integer

Response Formats

application/json, text/json

Sample:
1

application/xml, text/xml

Sample:
<int xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1</int>