Conversations

curl "https://intent-weasel-655.eu-west-1.convex.site/api/v1/conversations?pageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "conversationId": "conv_2601...",
      "agentId": "agent_7901...",
      "agentName": "Front desk",
      "startTimeUnixSecs": 1751880000,
      "callDurationSecs": 74,
      "messageCount": 12,
      "status": "done",
      "callSuccessful": "success",
      "callSummaryTitle": "Booked a cleaning",
      "mainLanguage": "en",
      "direction": "inbound",
      "rating": null
    }
  ],
  "nextCursor": "abc123",
  "hasMore": true
}

curl "https://intent-weasel-655.eu-west-1.convex.site/api/v1/conversations?pageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "conversationId": "conv_2601...",
      "agentId": "agent_7901...",
      "agentName": "Front desk",
      "startTimeUnixSecs": 1751880000,
      "callDurationSecs": 74,
      "messageCount": 12,
      "status": "done",
      "callSuccessful": "success",
      "callSummaryTitle": "Booked a cleaning",
      "mainLanguage": "en",
      "direction": "inbound",
      "rating": null
    }
  ],
  "nextCursor": "abc123",
  "hasMore": true
}

Conversations are the calls and chats your agents have handled. Use these endpoints to pull call logs into your own CRM or analytics.

List conversations

Returns conversations across your agents, newest first, with cursor pagination.

GET /conversations

string

Filter to one agent. Use the agent’s providerAgentId (from List agents).

string

Filter by outcome: success, failure, or unknown.

number

default:"30"

Results per page, 1–100.

string

The nextCursor from a previous response, to fetch the next page.

curl "https://intent-weasel-655.eu-west-1.convex.site/api/v1/conversations?pageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

array

Show conversation

string

The conversation’s unique id.

string

The voice-provider agent id that handled it.

string | null

The agent’s name.

number

Start time as a Unix timestamp (seconds).

number

Duration in seconds.

number

Number of messages exchanged.

string

The conversation status.

string

success, failure, or unknown.

string | null

A short generated title.

string | null

The primary language detected.

string | null

inbound, outbound, or null.

number | null

Rating, if any.

string | null

Pass back as cursor to get the next page.

boolean

Whether more pages remain.

{
  "data": [
    {
      "conversationId": "conv_2601...",
      "agentId": "agent_7901...",
      "agentName": "Front desk",
      "startTimeUnixSecs": 1751880000,
      "callDurationSecs": 74,
      "messageCount": 12,
      "status": "done",
      "callSuccessful": "success",
      "callSummaryTitle": "Booked a cleaning",
      "mainLanguage": "en",
      "direction": "inbound",
      "rating": null
    }
  ],
  "nextCursor": "abc123",
  "hasMore": true
}

Keep following nextCursor until hasMore is false. A page can occasionally come back empty while hasMore is true — that’s expected; just request the next page.

Get a conversation

Returns one conversation with its full transcript and analysis.

GET /conversations/{id}

string

required

The conversation id.

string

The conversation id.

string

The voice-provider agent id.

string | null

The agent’s name.

string

The conversation status.

number

Start time (Unix seconds).

number

Duration in seconds.

number | null

Estimated cost of the call in US dollars.

string

success, failure, or unknown.

string | null

A summary of the conversation.

string | null

A short generated title.

string | null

The primary language detected.

string | null

inbound, outbound, or null.

object | null

Show properties

string

inbound or outbound.

string

The other party’s number.

string

The agent’s number.

object

Variables passed into the agent at the start of the call.

array

Show item

string

The data point’s name.

string | null

The collected value.

array

Show turn

string

user, agent, or tool.

string | null

What was said.

number

Seconds into the call.

curl https://intent-weasel-655.eu-west-1.convex.site/api/v1/conversations/conv_2601... \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "conv_2601...",
  "agentId": "agent_7901...",
  "agentName": "Front desk",
  "status": "done",
  "startTimeUnixSecs": 1751880000,
  "callDurationSecs": 74,
  "callCostUsd": 0.0084,
  "callSuccessful": "success",
  "summary": "Caller booked a cleaning for next Tuesday.",
  "title": "Booked a cleaning",
  "mainLanguage": "en",
  "direction": "inbound",
  "phoneCall": {
    "direction": "inbound",
    "externalNumber": "+15551234567",
    "agentNumber": "+12089745876"
  },
  "dynamicVariables": {},
  "dataCollection": [
    { "name": "appointment_type", "value": "cleaning" }
  ],
  "transcript": [
    { "role": "agent", "message": "Hi, thanks for calling Acme Dental!", "timeInCallSecs": 0 }
  ]
}

Getting started

Your brand

Clients

Building agents

Chat & embedding

Calendar

API

Billing your clients

Account & billing

List conversations

Get a conversation

​List conversations

​Get a conversation

List conversations

Get a conversation