Skip to main content
GET
/
v1
/
dev
/
user
/
conversations
List conversations
curl --request GET \
  --url https://api.omi.me/v1/dev/user/conversations \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "conv_202",
    "created_at": "2025-01-20T13:50:00Z",
    "started_at": "2025-01-20T13:50:00Z",
    "finished_at": "2025-01-20T14:10:00Z",
    "language": "en",
    "source": "omi",
    "structured": {
      "title": "Feature Discussion",
      "overview": "Brainstorming session for new features",
      "emoji": "💼",
      "category": "business",
      "action_items": [],
      "events": []
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.omi.me/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Developer API key. Get one from Settings → Developer → Create Key in the Omi app. Keys are prefixed with omi_dev_.

Query Parameters

​
limit
integer
default:25

Maximum number of conversations to return.

​
offset
integer
default:0

Number of conversations to skip.

​
start_date
string<date-time>

Filter by start date (inclusive). ISO 8601 format.

​
end_date
string<date-time>

Filter by end date (inclusive). ISO 8601 format.

​
include_transcript
boolean
default:false

Include full transcript segments in the response.

​
categories
string

Comma-separated list of conversation categories to filter by (e.g. work,personal). Matches conversations whose category is any of the listed values (OR semantics).

​
folder_id
string

Filter conversations by folder ID. Each conversation belongs to at most one folder, so this is a single-value filter. Must be a non-empty string.

Minimum string length: 1
​
starred
boolean

Filter by starred status. Pass true for starred conversations only, false for non-starred.

Response

List of conversations.

​
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
object
​
transcript_segments
object[]

Transcript segments (only present when include_transcript=true).

​
geolocation
object
​
folder_id
string | null

ID of the folder this conversation belongs to, or null if not in any folder.

​
folder_name
string | null

Display name of the folder, or null if not in any folder.