---
title: "Return sleep cycles with extended data (experimental)"
method: GET
path: "/data/v0/{fulcra_userid}/sleep_cycles_extended"
tags: ["data", "sleep"]
---

# Return sleep cycles with extended data (experimental)

`GET /data/v0/{fulcra_userid}/sleep_cycles_extended`

## Request

- Base URL: `https://api.fulcradynamics.com`
- URL: `https://api.fulcradynamics.com/data/v0/{fulcra_userid}/sleep_cycles_extended`
- Auth: HTTP bearer

Extended version of sleep_cycles endpoint for experimentation.
Adds metric time series data (heart rate, respiratory rate, etc.) to each sleep cycle.

## Path parameters

- `fulcra_userid` string, uuid, required

## Query parameters

- `start_time` string, date-time, required: The starting timestamp in ISO8601 format (inclusive)
- `end_time` string, date-time, required: The ending timestamp in ISO8601 format (exclusive)
- `output` 'ndjson' | 'jstable' | 'jscolumns' | 'arrow' | 'arrowraw' | 'parquet' | 'csv' | 'quotecsv', required
- `cycle_gap` string, duration: Minimum time interval separating distinct cycles.
- `stages` integer[], nullable: Sleep stages to include. Defaults to all stages.
- `gap_stages` integer[], nullable: Sleep stages to consider as gaps in sleep cycles.
- `clip_to_range` boolean: Whether to clip the data to the requested date range. This is always done when requesting data for a user other than the authenticated user.
- `metrics` string[], nullable: Optional list of metrics to include as time series data (e.g., HeartRate, RespiratoryRate).
- `metric_calculations` TimeSeriesCalculation[], nullable: Statistics to calculate for each time window in metric time series.
- `metric_seconds_before` number: Number of seconds before each sleep cycle to include in metric time series data.
- `metric_seconds_after` number: Number of seconds after each sleep cycle to include in metric time series data.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api.md) · [All operations](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api/revisions/d85136fc304a?raw)