Convo API Docs

Authorization

AuthorizationRequiredBearer <token>

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

In: header

Query Parameters

limitinteger

Max results to return

Default: 20Maximum: 100

offsetinteger

Number of results to skip

Default: 0

searchstring

Search conversations by title

sincestring

Return conversations after this date (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": "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
  }
}

List conversations

Authorization

Query Parameters

Response

TypeScript