Crown Presses

The Crown Presses endpoint provides access to raw crown press events detected on the NOWATCH device.

GET /v1/timeline/events/crown_presses/{user_id}

Parameters

Name	Type	In	Description
user_id	UUID	Path	The unique identifier for the user.
start_date	Date	Query	The start date for the query period (format: YYYY-MM-DD).
end_date	Date	Query	The end date for the query period (format: YYYY-MM-DD).
days	Integer	Query	Days per page (default 7, max 30). Only applies to application/json cursor-based pagination — text/csv ignores days and returns the whole requested range in one response.
cursor	String	Query	Pagination cursor from the previous response. Only supported on application/json; returns 400 for CSV.

Response Formats

Header Value	Format
application/json	JSON (default)
text/csv	CSV

Response Status Codes

200 ok

The request was successful. A date range with no data returns 200 with an empty data array.

400 bad request

An invalid cursor was supplied, or cursor was combined with text/csv.

406 not acceptable

An unsupported Accept header was requested.

See Errors for authentication, validation, and rate-limit responses.

Example Request (JSON)

cURL

curl -X GET "https://research-api.nowatch.com/v1/timeline/events/crown_presses/YOUR_USER_ID?start_date=2024-04-01&end_date=2024-04-02" \
  -H "accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"

Example Response

200 OK

{
  "data": [
    {
      "datetime": "2024-04-01T10:00:00.000Z",
      "type": "CROWN_PRESS"
    },
    {
      "datetime": "2024-04-01T10:05:00.000Z",
      "type": "DOUBLE_CROWN_PRESS"
    }
  ],
  "next_cursor": null
}

Example Request (CSV)

cURL

curl -X GET "https://research-api.nowatch.com/v1/timeline/events/crown_presses/YOUR_USER_ID?start_date=2024-04-01&end_date=2024-04-02" \
  -H "accept: text/csv" \
  -H "X-API-KEY: YOUR_API_KEY"

Example Response (CSV)

200 OK

datetime,type
2024-04-01T10:00:00.000Z,CROWN_PRESS
2024-04-01T10:05:00.000Z,DOUBLE_CROWN_PRESS

Crown Press Types

Type	Description
CROWN_PRESS	Single press of the crown button
DOUBLE_CROWN_PRESS	Double press of the crown button