Get supportRequest a Demo
  • Get Started
    • Welcome
  • Guides
    • Authentication
    • Patient Management
    • Order Management
    • Device Management
    • Webhook Management
  • Webhooks
  • API Reference
  • Resources
    • OpenAPI Spec
    • Mobile SDK
LogoLogo
Get supportRequest a Demo
API ReferenceReadings Sleep Mat Duration

Record Sleep Mat Duration Reading

POST
/api/v3/sleep-mat-duration-reading
POST
/api/v3/sleep-mat-duration-reading
1curl -X POST https://app.impiloplatform.com/api/v3/sleep-mat-duration-reading \
2     -H "Impilo-API-Key: <Impilo-API-Key>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "bodyTurnOver": 5,
6  "deepSleep": 300,
7  "duration": "20:00~00:00",
8  "heartRate": 60,
9  "lightSleep": 155,
10  "readingTimestamp": "2024-07-04T00:00:00Z",
11  "rem": 20,
12  "respiration": 10,
13  "deviceId": 599,
14  "deviceTimeZoneOffset": -14400,
15  "manual": false
16}'
Try it
Records a sleep mat duration reading based on the provided request. Either a device ID, device identifier, or patient ID is required.
Was this page helpful?
Previous

Export Temperature Readings

Next
Built with
Export Temperature Readings
Records a sleep mat duration reading based on the provided request. Either a device ID, device identifier, or patient ID is required.

Authentication

Impilo-API-Keystring
API Key authentication via header

Request

This endpoint expects an object.
bodyTurnOverintegerRequired
Number of times the subject rolled over during the recorded period.
deepSleepintegerRequired
Number of minutes of detected deep sleep.
durationstringRequired
Duration of sleep during tracked period.
heartRateintegerRequired
Average heart rate per minutes during recorded period.
lightSleepintegerRequired
Number of minutes of detected light sleep.
readingTimestampstringRequiredformat: "date-time"
The UTC timestamp at which the reading was taken.
remintegerRequired
Number of minutes of detected rem sleep.
respirationintegerRequired
Respiratory rate per minute during sleep.
deviceIdlongOptional
The id of the device that took the reading.
deviceIdentifierstringOptional
The device identifier of the device that took the reading.
deviceTimeZoneOffsetintegerOptional
The offset of the device's timezone from UTC in seconds. Null if unavailable.
manualbooleanOptional
True if the reading value was entered manually, false or null otherwise.
patientIdlongOptional
The id of the patient that took the reading.

Response

OK
readingTimestampstringformat: "date-time"
The UTC timestamp at which the reading was taken.
bodyTurnOverinteger or null
deepSleepinteger or null
deviceobject or null
A device is an instance of an item. Impilo creates device records for items that are serialized, i.e., items where each individual unit is identified by a serial number, IMEI, or other identifier.
deviceTimeZoneOffsetinteger or null
The offset of the device's timezone from UTC in seconds. Null if unavailable.
durationstring or null
heartRateinteger or null
idlong or null
Unique identifier for the reading.
itemobject or null
An item is any of the supplies handled by Impilo. Examples include medical devices like a blood pressure monitor or weight scale, but the term 'item' also refers to non-medical supplies like AAA batteries and package inserts. A customer catalog is a subset of all items supported by Impilo. This is set during onboarding and may be modified by your account manager at any time. A customer may view the items in their catalog.
lightSleepinteger or null
manualboolean or null
True if the reading value was entered manually, false or null otherwise.
patientobject or null
The Patient resource represents a patient in the Impilo system. It includes personal information, contact details, and enrollment status.
patientTimeZoneOffsetinteger or null
The offset of the patient's timezone from UTC in seconds. Null if unavailable.
reminteger or null
respirationinteger or null

An item is any of the supplies handled by Impilo. Examples include medical devices like a blood pressure monitor or weight scale, but the term ‘item’ also refers to non-medical supplies like AAA batteries and package inserts. A customer catalog is a subset of all items supported by Impilo. This is set during onboarding and may be modified by your account manager at any time. A customer may view the items in their catalog.