Oura Sleep Periods
oura_list_sleepRead-onlyIdempotent
List Oura sleep period records with sleep stages and timing. Filter by date range and paginate results for detailed sleep analysis.
Instructions
List detailed Oura sleep period records, including sleep stages and timing where available. Requires sleep scope. Not medical advice.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Oura page number. | |
| after | No | Only return Oura records after this time. Converted to an Oura start_date. | |
| limit | No | Local page-size hint used for pagination safety. | |
| before | No | Only return Oura records before this time. Converted to an Oura end_date. | |
| all_pages | No | Fetch multiple pages up to max_pages. | |
| max_pages | No | Maximum pages to fetch when all_pages is true. | |
| privacy_mode | No | Optional per-call privacy override. Defaults to OURA_PRIVACY_MODE or structured. raw returns upstream Oura JSON. summary minimizes sensitive health and profile details. | |
| response_format | No | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| records | Yes | ||
| endpoint | Yes | ||
| has_more | Yes | ||
| next_page | No | ||
| privacy_mode | Yes | ||
| pages_fetched | Yes |