Skip to main content
GET
/
episodes
/
{group_id}
Get Episodes
curl --request GET \
  --url https://memory.stru.ai/episodes/{group_id} \
  --header 'X-API-Key: <x-api-key>'
{
  "422": {},
  "episodes": [
    {
      "uuid": "<string>",
      "group_id": "<string>",
      "source_description": "<string>",
      "timestamp": "<string>"
    }
  ]
}

​
Overview

Retrieve episodes for a specific group (user). Use the last_n query parameter to limit the number of episodes returned.

​
Authentication

​
X-API-Key
string
required
Your API key for authentication
X-API-Key: windowseat

​
Path Parameters

​
group_id
string
required
User identifier (group ID) to retrieve episodes for
/episodes/user_oauth_sub

​
Query Parameters

​
last_n
integer
required
Number of recent episodes to retrieve
?last_n=10

​
Response

​
episodes
array
Array of episode objects

​
Example Request

curl -X GET "https://memory.stru.ai/episodes/user_oauth_sub?last_n=10" \
  -H "X-API-Key: windowseat"

​
Example Response

{
  "episodes": [
    {
      "uuid": "episode_uuid_123",
      "group_id": "user_oauth_sub",
      "source_description": "conv_12345",
      "timestamp": "2025-10-11T03:00:00Z"
    },
    {
      "uuid": "episode_uuid_456",
      "group_id": "user_oauth_sub",
      "source_description": "conv_12345",
      "timestamp": "2025-10-11T02:45:00Z"
    }
  ]
}

​
Error Responses

​
422
Validation Error
Request validation failed - missing required parameters
{
  "detail": [
    {
      "loc": ["query", "last_n"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

​
Use Cases

Check Processing Status

Use this endpoint to verify that episodes have been added to the system before querying for facts

Debug & Monitoring

List recent episodes to debug issues or monitor user activity

Audit Trail

Review what data has been added for a user