Devices

Associate Device

PATCH

This endpoint associates the device to the patient provided in the request body.

In order to associate a device with a patient, all of the following must apply:

  • The Patient must be associated with the Customer making the request
  • The Device must be owned by the Customer making the request
  • The Device must be associated with a non-Impilo site
  • The Device must have a current status of “availableAtSite”

For more information see the AssociateDeviceRequest Model.

Request

This endpoint expects an object.
deviceId
integerOptional
The ID of the device. Either this value or a Device Identifier are required to identify the Device.
deviceIdentifier
stringOptional
The Identifier, such as a Serial Number, of the device. Either this value or a Device Id are required to identify the Device.
patientId
integerOptional
The ID of the patient to have the Device associated to. Either this value or a Patient External Identifier are required to identify who should be (dis)associated with the device.
patientExternalIdentifier
stringOptional
The External Identifier of the patient to have the Device (dis)associated to. Either this value or a Patient Id are required to identify who should be (dis)associated with the device.
PATCH
1curl -X PATCH https://app.impiloplatform.com/api/v3/device/associate-patient \
2 -H "Impilo-API-Key: <apiKey>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "deviceId": 1,
6 "patientExternalIdentifier": "external-identifier"
7}'