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

# Get Conversations

`GET /v1/dev/user/conversations`

Get conversations with optional transcript inclusion.

- **include_transcript**: If True, includes full transcript_segments in the response
- **folder_id**: Filter by folder ID (must be a non-empty string if provided)
- **starred**: Filter by starred status (true/false)

## Query parameters

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

## Response `200`

Successful Response

- DeveloperConversation[]
  - `created_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required
  - `folder_id` string, nullable
  - `folder_name` string, nullable
  - `geolocation` Geolocation
    - `address` string, nullable
    - `google_place_id` string, nullable
    - `latitude` number, required
    - `location_type` string, nullable
    - `longitude` number, required
  - `id` string, required
  - `language` string, nullable
  - `source` string, nullable
  - `started_at` string, date-time, nullable, required
  - `structured` DeveloperConversationStructured, required
    - `action_items` DeveloperConversationActionItem[]
      - `completed` boolean
      - `completed_at` string, date-time, nullable
      - `conversation_id` string, nullable
      - `created_at` string, date-time, nullable
      - `description` string, required
      - `due_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `category` 'personal' | 'education' | 'health' | 'finance' | 'legal' | 'philosophy' | 'spiritual' | 'science' | 'entrepreneurship' | 'parenting' | 'romantic' | 'travel' | 'inspiration' | 'technology' | 'business' | 'social' | 'work' | 'sports' | 'politics' | 'literature' | 'history' | 'architecture' | 'music' | 'weather' | 'news' | 'entertainment' | 'psychology' | 'real' | 'design' | 'family' | 'economics' | 'environment' | 'other', required
    - `emoji` string
    - `events` DeveloperConversationEvent[]
      - `created` boolean
      - `description` string
      - `duration` integer
      - `start` string, date-time, required
      - `title` string, required
    - `overview` string, required
    - `title` string, required
  - `transcript_segments` DeveloperTranscriptSegment[], nullable
    - `end` number, required
    - `id` string, nullable
    - `speaker_id` integer, nullable
    - `speaker_name` string, nullable
    - `start` number, required
    - `text` string, required

## Other responses

- `401` — Missing or invalid authentication credentials.
- `403` — Authenticated, but the token does not grant the required scope.
- `422` — Validation Error

## Changes

> 28 revisions in range; 1 could not be searched.

- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status

[Full 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/3add0ce9bc4f/schema)