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

- **2026-06-29** `a638dcb24d6f` — 15 breaking, 38 warning, 35 info
  - response property `detail` list-of-types was widened by adding types `array and object` to media type `application/json` of response `401`
  - response property `detail` list-of-types was widened by adding types `array and object` to media type `application/json` of response `403`
  - response property `items/finished_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/folder_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …84 more
- **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/a638dcb24d6f/schema)