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": []
    }
  }
]

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.

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