Skip to main content
GET
/
ai-sessions
cURL
curl --request GET \
  --url https://api.konvoai.com/ai-sessions \
  --header 'x-api-key: <api-key>'
{
  "count": 123,
  "result": [
    {
      "id": "2eac78c7-ef64-49cb-82f0-7280b555f015",
      "workspace_id": "465d610c-43df-4c87-8396-8eb9742122c4",
      "feed_id": "6bdda998-40a0-4f61-9e7d-ca7f4879b13d",
      "contact_id": "f1349acb-b4d4-4220-b90a-36ef170ddd4a",
      "external_user_id": "4915142424351",
      "channel": "whatsapp",
      "created_at": "2026-02-25T16:46:34.206Z",
      "status": {
        "session_id": "2eac78c7-ef64-49cb-82f0-7280b555f015",
        "completed": true,
        "unresolved": false,
        "completed_at": "2026-02-25T16:50:00.000Z",
        "last_message_date": "2026-02-25T16:49:30.000Z",
        "last_updated": "2026-02-25T16:50:00.000Z"
      },
      "state": {
        "session_id": "2eac78c7-ef64-49cb-82f0-7280b555f015",
        "type": "CONCIERGE",
        "sub_intent_type": "CONCIERGE",
        "trail": [
          {}
        ]
      },
      "messages": [
        {
          "message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "session_id": "2eac78c7-ef64-49cb-82f0-7280b555f015",
          "initiator_origin": "RECIPIENT",
          "message": "Hi, I need help with my order",
          "created_at": "2026-02-25T16:46:40.000Z"
        }
      ]
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
page
integer<int32>

Pointer for the current page of the paginated query

​
limit
integer<int32>

The maximum number of results to return, maximum is 200

​
updated_at_min
string<date-time>

Filter by sessions created after a certain date

​
updated_at_max
string<date-time>

Filter by sessions created before a certain date

​
messages
boolean
default:false

Set to true to include the text messages exchanged in each session (tool calls are excluded)

​
state
boolean
default:false

Set to true to include the session status (resolved/unresolved) and AI state (skill type, trail)

Response

Get AI sessions response

​
count
integer

Total count of sessions matching the query

​
result
object[]

Resulting query