List conversations

Returns your recorded calls, newest first. search matches the title or any words in the transcript, case-insensitive. since keeps only transcript from that time on, so for a call that started earlier, startTime, duration and segmentCount cover only the later part. pagination.total counts every matching call.

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

Query Parameters

limitinteger

Calls per page, 1 to 100. Larger values are lowered to 100.

Default: 20Minimum: 1Maximum: 100

offsetinteger

Number of calls to skip

Default: 0Minimum: 0

searchstring

Matches the title or transcript text, case-insensitive

sincestring

Only transcript from this time on (ISO 8601)

Format: "date-time"

curl -X GET "https://www.itsconvo.com/api/v1/conversations?limit=20&offset=0&search=%3Cstring%3E&since=2019-08-24T14%3A15%3A22Z" \
  -H "Authorization: Bearer <token>"

List of conversations

{
  "data": [
    {
      "id": "session_1773842400000",
      "title": "Q1 Planning Review",
      "startTime": "2026-03-18T14:00:00Z",
      "endTime": "2026-03-18T14:45:00Z",
      "duration": 45,
      "segmentCount": 128
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0
  }
}

List conversations

Authorization

Query Parameters

Response

TypeScript