---
title: "List conversations"
method: GET
path: "/v1/dev/user/conversations"
tags: ["Conversations"]
---

# List conversations

`GET /v1/dev/user/conversations`

Retrieve your conversation transcripts. Only returns completed, non-discarded conversations.

## Query parameters

- `limit` integer
- `offset` integer
- `start_date` string, date-time
- `end_date` string, date-time
- `include_transcript` boolean
- `categories` string
- `folder_id` string
- `starred` boolean

## Response `200`

List of conversations.

- Conversation[]
  - `id` string — Unique identifier.
  - `created_at` string, date-time — When the conversation record was created.
  - `started_at` string, date-time — When the conversation started.
  - `finished_at` string, date-time — When the conversation ended.
  - `language` string — Language code (e.g. `en`).
  - `source` string — Source device or app.
  - `structured` StructuredData
    - `title` string — AI-generated title.
    - `overview` string — Summary of the conversation.
    - `emoji` string — Representative emoji.
    - `category` string — Category (work, personal, etc.).
    - `action_items` ActionItemSummary[]
      - `description` string
      - `completed` boolean
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `due_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
    - `events` object[]
  - `transcript_segments` TranscriptSegment[] — Transcript segments (only present when `include_transcript=true`).
    - `id` string — Segment identifier.
    - `text` string — The transcribed text.
    - `speaker_id` integer — Numeric speaker identifier.
    - `speaker_name` string — Human-readable speaker name.
    - `start` number — Start timestamp in seconds.
    - `end` number — End timestamp in seconds.
  - `geolocation` Geolocation
    - `latitude` number
    - `longitude` number
    - `address` string
    - `google_place_id` string
    - `location_type` string
  - `folder_id` string, nullable — ID of the folder this conversation belongs to, or null if not in any folder.
  - `folder_name` string, nullable — Display name of the folder, or null if not in any folder.

## Other responses

- `400` — Invalid `categories` value (must be a comma-separated list of valid `CategoryEnum` values).
- `401` — Invalid or missing API key.
- `403` — Insufficient permissions. Required scope: `conversations:read`.
- `422` — Validation error.

## Changes

- **2026-05-01** `73d7be6fb953` — 1 info
  - added the non-success response with the status `400`
- **2026-04-30** `bab700207960` — 2 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `422`
- **2026-04-30** `1b86160bd22e` — 5 info
  - added the new optional `query` request parameter `categories`
  - added the new optional `query` request parameter `folder_id`
  - added the new optional `query` request parameter `starred`
  - added the optional property `items/folder_id` to the response with the `200` status
  - …1 more
- **2026-03-24** `b791dc93aa91` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/basedhardware/apis/omi-developer-api/changes/v1/dev/user/conversations/get.md)

---

[API](https://skmtc.dev/basedhardware/apis/omi-developer-api.md) · [All operations](https://skmtc.dev/basedhardware/apis/omi-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basedhardware/omi-developer-api/revisions/e3d644927120/schema)