---
title: "Get Today Memory"
method: GET
path: "/memories/today"
tags: ["Memories"]
---

# Get Today Memory

`GET /memories/today`

Get the memory to surface now, or null if there is nothing to show.

Having nothing to surface is a normal state for a small or new library, so
this returns 200 with a null payload rather than a 404.

## Response `200`

Successful Response

- GetTodayMemoryResponse
  - `success` boolean, required
  - `message` string, required
  - `data` GetTodayMemoryData, required — The memory to surface now, if any. `memory` is null rather than a 404 when nothing qualifies: this endpoint is polled, and an empty library is a normal state, not an error.
    - `memory` MemoryStory — A memory with its full image set, for the story viewer.
      - `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
      - `images` MemoryImageItem[]
        - `id` string, required
        - `path` string, required
        - `thumbnailPath` string, nullable
        - `captured_at` string, nullable
        - `latitude` number, nullable
        - `longitude` number, nullable
        - `isFavourite` boolean
        - `sort_order` integer, required
        - `score` number, nullable
      - `videos` MemoryVideoItem[]
        - `id` string, required
        - `path` string, required
        - `thumbnailPath` string, nullable
        - `captured_at` string, nullable
        - `duration` number, nullable
        - `isFavourite` boolean
        - `sort_order` integer, required
        - `score` number, nullable
      - `signals` object, nullable

## Other responses

- `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)