---
title: "List dating conversations, sorted by what can be acted on"
method: GET
path: "/api/v1/dating"
---

# List dating conversations, sorted by what can be acted on

`GET /api/v1/dating`

## Request

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

The only list where dating contacts appear (relationship family dating, or with a dating profile). Each row carries whose turn it is, how long the conversation has been still and the urgency computed from the last 200 messages. `coolingCount` counts the rows where it is the user's turn and the conversation has been still for 2 days or more.

## Query parameters

- `sort` 'recent' | 'oldest' | 'network' | 'stale' | 'her_silence' | 'my_turn'

## Response `200`

The rows, already sorted

- object
  - `rows` DatingRow[]
    - `contactId` integer
    - `conversationId` integer, nullable
    - `name` string
    - `nickname` string, nullable
    - `network` string, nullable
    - `originNetwork` string, nullable
    - `age` integer, nullable
    - `distanceKm` integer, nullable
    - `residency` 'local' | 'visiting' | 'unknown'
    - `lastMessageAt` string, date-time, nullable
    - `herLastReplyAt` string, date-time, nullable
    - `whoseTurn` string, nullable: me, her or null.
    - `sheAskedQuestion` boolean
    - `daysSinceLastMessage` number, nullable: One decimal.
    - `urgency` 'owes_answer' | 'owes_reply' | 'waiting_on_her' | 'needs_new_reason' | 'fresh'
    - `urgencyMessage` string: Spanish sentence to show as is.
    - `reactionSignal` string, nullable: faster_than_usual, normal, slower_than_usual or null.
    - `hasProfile` boolean
    - `coverPhotoId` integer, nullable: First photo with a face by position (falls back to the first photo), for the avatar.
    - `investmentLevel` 'low' | 'balanced' | 'high' | 'unknown': Who puts in more effort in the loaded messages (deterministic, no model call): low = she invests little, high = she invests a lot.
    - `createdAt` string, date-time, nullable
  - `coolingCount` integer
  - `sort` string
  - `quota` object: This month's dating usage against the plan (Madrid calendar month). `limit` null means no ceiling.
    - `images` object
      - `used` integer
      - `limit` integer, nullable
    - `suggestions` object
      - `used` integer
      - `limit` integer, nullable
    - `resetsAt` string, date-time

---

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