Feelings API Reference

The Feelings endpoint provides access to user-reported daily "How was your day?" and "How was your sleep?" responses.

GET /v1/feelings/{user_id}/{type}

Parameters

Name	Type	In	Description
user_id	UUID	Path	The ID of the user.
type	Enum	Path	The type of feelings to retrieve. Allowed values: DAY, SLEEP.
start_date	Date	Query	Start date for the data retrieval (format: YYYY-MM-DD).
end_date	Date	Query	End date for the data retrieval (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

Example Request (JSON)

curl -X GET "https://research-api.nowatch.com/v1/feelings/YOUR_USER_ID/DAY?start_date=2023-01-01&end_date=2023-01-31" \
     -H "accept: application/json" \
     -H "X-API-KEY: YOUR_API_KEY"

Example Response (JSON)

200 OK

{
  "data": [
    {
      "date": "2023-01-01",
      "value": "GOOD"
    }
  ],
  "next_cursor": null
}

Example Request (CSV)

curl -X GET "https://research-api.nowatch.com/v1/feelings/YOUR_USER_ID/SLEEP?start_date=2023-01-01&end_date=2023-01-31" \
     -H "accept: text/csv" \
     -H "X-API-KEY: YOUR_API_KEY"

Example Response (CSV)

200 OK

date,value
2023-01-01,GOOD