---
title: "Get recent emotional states"
method: GET
path: "/emotional-state/recent"
tags: ["Emotional State"]
---

# Get recent emotional states

`GET /emotional-state/recent`

## Request

- Base URL: `https://api.hyperspell.com`
- URL: `https://api.hyperspell.com/emotional-state/recent`
- Auth: HTTP bearer

Return up to `limit` most recent emotional states, newest first.

Optionally filter by ``relationship_id``.

## Query parameters

- `relationship_id` string, nullable
- `limit` integer

## Headers

- `X-As-User` string, nullable: Optionally set this header to act as a specific user when using an API Key, equivalent to first exchanging the API Key for a User Token

## Response `200`

Successful Response

- EmotionalStateLatest[]
  - `resource_id` string, required
  - `summary` string, required
  - `extracted_at` string, required
  - `session_id` string, nullable, required
  - `relationship_id` string, nullable, required
  - `summary_source` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/hyperspell/apis/hyperspell-api.md) - [All operations](https://skmtc.dev/hyperspell/apis/hyperspell-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hyperspell/apis/hyperspell-api/revisions/9bafd1215a0f?raw)