---
title: "List active stories from mutual follows, grouped by user"
method: GET
path: "/stories"
tags: ["Stories"]
---

# List active stories from mutual follows, grouped by user

`GET /stories`

## Request

- Base URL: `https://api.shopseen.com/v1`
- URL: `https://api.shopseen.com/v1/stories`
- Auth: HTTP bearer

## Response `200`

Grouped stories

- object
  - `story_groups` GroupedStories[]
    - `user` UserProfile: Public profile. bio is included only for mutual follows.
      - `id` string, uuid
      - `display_name` string
      - `avatar_url` string, nullable
      - `bio` string, nullable
      - `is_mutual_follow` boolean
      - `is_following` boolean
      - `is_followed_by` boolean: True if this user follows the authenticated user
      - `mutual_follow_count` integer
    - `stories` Story[]
      - `id` string, uuid
      - `user_id` string, uuid
      - `media_url` string
      - `media_type` 'photo' | 'video'
      - `expires_at` string, date-time
      - `created_at` string, date-time

---

[API](https://skmtc.dev/shopseen/apis/a-side-api.md) - [All operations](https://skmtc.dev/shopseen/apis/a-side-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shopseen/apis/a-side-api/revisions/f37f989e90da?raw)