---
title: "List Memories"
method: GET
path: "/memories"
tags: ["Memories"]
---

# List Memories

`GET /memories`

List memory cards, newest first. Backs the history filmstrip and grid.

## Query parameters

- `limit` integer — Maximum memories to return
- `offset` integer — Number of memories to skip
- `event_type` string, nullable — Filter by anniversary, import_event or semantic_event
- `include_viewed` boolean — Include already-viewed memories
- `include_dismissed` boolean — Include dismissed memories

## Response `200`

Successful Response

- GetMemoriesResponse
  - `success` boolean, required
  - `message` string, required
  - `data` GetMemoriesData, required — Paginated memory cards.
    - `memories` MemoryCard[]
      - `memory_id` string, required
      - `dedupe_key` string, required
      - `event_type` 'anniversary' | 'import_event' | 'semantic_event', required
      - `status` 'pending' | 'complete' | 'failed' | 'empty', required
      - `title` string, required
      - `subtitle` string, nullable
      - `place_label` string, nullable
      - `center_lat` number, nullable
      - `center_lon` number, nullable
      - `surface_date` string, required
      - `period_start` string, nullable
      - `period_end` string, nullable
      - `image_count` integer
      - `video_count` integer
      - `cover_image_id` string, nullable
      - `cover_thumbnail_path` string, nullable
      - `score` number
      - `notified_at` string, nullable
      - `viewed_at` string, nullable
      - `dismissed` boolean
      - `created_at` string, nullable
    - `total_count` integer

## Other responses

- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/aossie-org/apis/pictopy.md) · [All operations](https://skmtc.net/aossie-org/apis/pictopy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aossie-org/pictopy/revisions/a6c11e6b42e4/schema)