---
title: "List notifications"
method: GET
path: "/api/v1/notifications"
---

# List notifications

`GET /api/v1/notifications`

## Request

- Base URL: `https://memchats.com`
- URL: `https://memchats.com/api/v1/notifications`
- Auth: HTTP bearer

Two sources in one list, newest first: what the memory editor learned (`kind: "memory_operation"`) and the notices the product writes, the end of an import (`kind: "memory_ready"`, with `deep_link` to the conversation and `read`) and the daily dating reminder (`kind: "dating_cooling"`, no contact and no names by design, `deep_link: "/app/dating"`). Ids come from two tables, so a stable client key is the pair (kind, id).

## Query parameters

- `family` 'all' | 'family' | 'partner' | 'dating' | 'friends' | 'work' | 'professional' | 'other'

## Response `200`

Up to twenty cards, newest first

- object
  - `notifications` object[]
    - `id` integer
    - `kind` 'memory_operation' | 'memory_ready' | 'dating_cooling'
    - `tag` string
    - `tag_color` string
    - `contact_id` integer, nullable
    - `contact_name` string
    - `title` string
    - `body` string
    - `time` string, date-time
    - `deep_link` string, nullable
    - `read` boolean

---

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