Skip to content
/
Delete users measurements

NOWATCH API (0.9.0)

The NOWATCH API

Download OpenAPI description
index.json
index.yaml
Overview
Languages
Servers
Mock server

https://docs.api.nowatch.tech/_mock/apis/

https://docs.api.nowatch.tech/nowatch/

auth

User authentication

Operations

user

User data routes

Operations

firmware

Firmware updates and downloads

Operations

admin-firmware

Admin firmware management

Operations

measurement

Time series health data (heart rate, temperature, activity, etc.)

Operations

Fetch users measurements

Request

Security
bearer
Query
typestringrequired
Enum"HEART_BEAT""HEART_RATE""HEART_RATE_GRAPH""RESPIRATION_RATE""RESTING_HEART_RATE""TEMPERATURE""ACTIVITY_COUNT""ACTIVITY_TYPE""ACTIVITY_CADENCE""MOTION_GRAPH"
sortstringrequired
Enum"ASC""DESC"
start_daystringrequired
end_daystringrequired
Headers
shared-userstring

The ID of the user to fetch measurements for (optional)

curl -i -X GET \
  'https://docs.api.nowatch.tech/_mock/apis/v1/measurement?type=HEART_BEAT&sort=ASC&start_day=string&end_day=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'shared-user: string'

Responses

Bodyapplication/jsonArray [
valuesstringrequired
Example: "{ \"SECONDS_AFTER_MIDNIGHT\": [VALUE, QUALITY (0-4)], \"SECONDS_AFTER_MIDNIGHT\": [VALUE, QUALITY (0-4)], ... }"
countnumberrequired
Example: 10
typestringrequired
Enum"HEART_BEAT""HEART_RATE""HEART_RATE_GRAPH""RESPIRATION_RATE""RESTING_HEART_RATE""TEMPERATURE""ACTIVITY_COUNT""ACTIVITY_TYPE""ACTIVITY_CADENCE""MOTION_GRAPH"
daystring(date-time)required
Example: "2025-08-09T00:00:00.000Z"
createdstring(date-time)required
updatedAtstring(date-time)required
]
Response
application/json
[
  {
    "values": "{ \"SECONDS_AFTER_MIDNIGHT\": [VALUE, QUALITY (0-4)], \"SECONDS_AFTER_MIDNIGHT\": [VALUE, QUALITY (0-4)], ... }",
    "count": 10,
    "type": "HEART_BEAT",
    "day": "2025-08-09T00:00:00.000Z",
    "created": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
]

Delete users measurements

Request

Security
bearer
Query
typestringrequired
Enum"HEART_BEAT""HEART_RATE""HEART_RATE_GRAPH""RESPIRATION_RATE""RESTING_HEART_RATE""TEMPERATURE""ACTIVITY_COUNT""ACTIVITY_TYPE""ACTIVITY_CADENCE""MOTION_GRAPH"
start_daystringrequired
end_daystringrequired
curl -i -X DELETE \
  'https://docs.api.nowatch.tech/_mock/apis/v1/measurement?type=HEART_BEAT&start_day=string&end_day=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Measurements are deleted

Response
No content

Upload users measurements in a compressed ZIP file

Request

This endpoint is used to upload time series data to the backend. The request is a multipart/form-data request with two parts:

  1. file: The zipped CSV file containing the time-series data.
  2. type: The name of the table the data belongs to.

For extra context visit: Measurements Context

Security
bearer
Bodyapplication/jsonrequired
typestringrequired
Enum"HEART_BEAT""HEART_RATE""HEART_RATE_GRAPH""RESPIRATION_RATE""RESTING_HEART_RATE""TEMPERATURE""ACTIVITY_COUNT""ACTIVITY_TYPE""ACTIVITY_CADENCE""MOTION_GRAPH"
curl -i -X POST \
  https://docs.api.nowatch.tech/_mock/apis/v1/measurement/upload \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "HEART_BEAT"
  }'

Responses

Successful request

Bodyapplication/json
statusstring
Value"success"
Response
application/json
{
  "status": "success"
}

Shows the latest measurements dates for a user per type

Request

Security
bearer
curl -i -X GET \
  https://docs.api.nowatch.tech/_mock/apis/v1/measurement/oldest \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/jsonArray [
typestringrequired
Enum"HEART_BEAT""HEART_RATE""HEART_RATE_GRAPH""RESPIRATION_RATE""RESTING_HEART_RATE""TEMPERATURE""ACTIVITY_COUNT""ACTIVITY_TYPE""ACTIVITY_CADENCE""MOTION_GRAPH"
earlieststring(date-time)required
lateststring(date-time)required
]
Response
application/json
[
  {
    "type": "HEART_BEAT",
    "earliest": "2019-08-24T14:15:22Z",
    "latest": "2019-08-24T14:15:22Z"
  }
]

insight

User insights, feedback, and reflections

Operations

session

Activity session tracking

Operations

checkin

User check-ins and wellness tracking

Operations

alarm

User alarm management

Operations

day-feedback

Daily feedback and mood tracking

Operations

sleep

Sleep logs and sleep data

Operations

activity

Sessions wrapper for activities

Operations

intention

Sessions wrapper for intentions

Operations

statistics

Aggregated health statistics

Operations

sharing

Manage sharing your data with other people

Operations

shared

Manage other people's data shared with you

Operations

telemetry

Application telemetry data (spans, metrics, logs)

Operations