Skip to main content
GET
/
api
/
v1
/
conversations
List conversations
curl --request GET \
  --url https://www.itsconvo.com/api/v1/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "sess_a1b2c3",
      "title": "Q1 Planning Review",
      "startTime": "2026-03-18T14:00:00Z",
      "endTime": "2026-03-18T14:45:00Z",
      "duration": 45,
      "segmentCount": 128,
      "linkedCalendarEventId": null
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0
  }
}

Authorizations

Authorization
string
header
required

API key as Bearer token. Generate keys in your Convo dashboard settings.

Query Parameters

limit
integer
default:20

Max results to return

Required range: x <= 100
offset
integer
default:0

Number of results to skip

Search conversations by title

since
string<date-time>

Return conversations after this date (ISO 8601)

Response

List of conversations

data
object[]
pagination
object