---
title: "Get emotion detections"
method: GET
path: "/api/v1/data/emotions"
---

# Get emotion detections

`GET /api/v1/data/emotions`

## Request

- Base URL: `https://moda.dev`
- URL: `https://moda.dev/api/v1/data/emotions`
- Auth: API key in header `x-api-key`

Returns multi-family user-emotion detections and their analyzed-trace denominator.

## Query parameters

- `days_back` integer
- `limit` integer
- `offset` integer
- `family` 'frustration' | 'disapproval' | 'sadness' | 'confusion' | 'anxiety' | 'trust' | 'positive'
- `user_id` string
- `conversation_id` string
- `group_by` 'detection' | 'trace'
- `search` string
- `status` 'all' | 'detected'
- `elicitor` 'bot' | 'external' | 'self' | 'ambiguous'
- `trajectory` 'none' | 'building' | 'peak' | 'resolved' | 'sustained'
- `signals` string
- `sort` 'score' | 'risk_score' | 'detected_at' | 'message_count'
- `order` 'asc' | 'desc'
- `conversation_ids` string
- `cohort` string

## Response `200`

Successful response.

- object: Emotion summary, detections, pagination information, and `processing` ({ enabled, setting: "signals.frustration" }) reporting whether the tenant's emotion/frustration analysis is switched on.

## Other responses

- `401`: The x-api-key header is missing, invalid, or revoked.
- `404`: The requested resource was not found.

---

[API](https://skmtc.dev/moda-dev/apis/moda-data-api.md) - [All operations](https://skmtc.dev/moda-dev/apis/moda-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moda-dev/apis/moda-data-api/revisions/19a11ad88cf6?raw)