---
title: "Read a contact"
method: GET
path: "/api/v1/contacts/{id}"
---

# Read a contact

`GET /api/v1/contacts/{id}`

## Request

- Base URL: `https://memchats.com`
- URL: `https://memchats.com/api/v1/contacts/{id}`
- Auth: HTTP bearer

Who this person is to the user, the note kept about them, and `reimportSuggested`: three weeks without a new message on a contact whose history has already been read once.

## Path parameters

- `id` integer, required

## Response `200`

The contact row, the reimport nudge, and `importing`: the live sweep of this contact or null. While it is not null the memory of this contact is still being built.

- object
  - `id` integer
  - `name` string
  - `display_name` string, nullable
  - `relationship_type` string, nullable
  - `context_note` string, nullable
  - `created_at` string, date-time, nullable
  - `reimportSuggested` boolean
  - `importing` ImportingStatus, nullable: Non-null while the initial memory sweep of this contact is running. `phase` alternates between reading a stretch of conversation and filing what was found in it; a pass is about a minute, which is why both are published.
    - `processed` integer: Messages read so far.
    - `total` integer: Messages this sweep will read.
    - `passIndex` integer
    - `passCount` integer
    - `phase` 'reading' | 'writing'
    - `passRange` object, nullable: The stretch of conversation the current pass covers.
      - `fromMessageId` integer
      - `toMessageId` integer
      - `fromAt` string, date-time
      - `toAt` string, date-time
      - `messages` integer
    - `startedAt` string, date-time
    - `updatedAt` string, date-time: Last heartbeat. `startedAt` alone cannot tell a sweep that is working from one whose worker died.

## Other responses

- `404`: Not found

---

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