---
title: "Analyze Session"
method: POST
path: "/api/v1/sleep/analyze-session"
tags: ["Sleep Wellness"]
---

# Analyze Session

`POST /api/v1/sleep/analyze-session`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/sleep/analyze-session`
- Auth: none declared

Full sleep session analysis.

Accepts sleep metrics and returns comprehensive analysis with
sleep score, stage estimates, and frequency recommendations.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `x_api_key` string, nullable

## Request body

- SleepSessionRequest
  - `total_sleep_time_min` number, required: Total sleep time in minutes
  - `time_in_bed_min` number, required: Total time in bed in minutes
  - `sleep_onset_latency_min` number: Minutes to fall asleep
  - `deep_sleep_pct` number: Deep sleep percentage
  - `rem_sleep_pct` number: REM sleep percentage
  - `awakening_count` integer: Number of awakenings
  - `breathing_rate` number: Average breathing rate Hz
  - `breathing_regularity` number: Breathing regularity 0-1
  - `heart_rate_proxy` number: Estimated heart rate BPM
  - `body_position_changes` integer: Position changes during night

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)