# Household Insights [BETA]

## Get Sleep-Wake Settings

 - [GET /sleep_times/settings](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/household-insights-beta/get_sleep_times-settings.md): Both the owner or the member bound to the network can consume this endpoint. Responds to the application whether sleep feature is enabled, and the user-provided household sleep time and household wake time.

If the owner has not yet enabled the feature via, the following template is sent:



A record of the household settings is made only when the feature is enabled for the first time.

## Set Sleep-Wake Settings

 - [POST /sleep_times/settings](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/household-insights-beta/post_sleep_times-settings.md): Only the user with a role of "owner" can make a request to this endpoint.

## Household Sleep-Wake Times Data

 - [GET /sleep_times/data/{queried_days}](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/household-insights-beta/get_sleep_times-data-queried_days.md): This endpoint retrieves the timezone of the user from the network model and supplies it to the micro service. The micro service will return hour values for wake and sleep in the network's timezone.

## [BETA] Retrieve Activity Insights

 - [GET /insights/v2/activity](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/household-insights-beta/get_activity_insights_v2__network_id__activity_get.md): [BETA] Activity Insights provides you activity related data.

## Household Activity

 - [GET /activity/{queried_days}](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/household-insights-beta/get_activity-queried_days.md): Available in App Cloud v1-3-22 and above.
Requires the Home-Insights Microservice enabled within MNS.