Skip to content
Kalipto Devs Platform — API Docs

List Conversations

GET
/platform/v1/conversations
 
curl --request GET \
  --url https://example.com/platform/v1/conversations

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
channel_id
Any of:
integer
status
Any of:
string
/^(active|ended)$/
after
Any of:
string
before
Any of:
string
limit
Any of:
integer

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
PlatformConversationPage
object
data
required
Data
Array<object>
PlatformConversationResponse
object
created_at
required
Created At
string format: date-time
ended_at
Any of:
string format: date-time
id
required
Id
integer
inbound_count
required
Inbound Count
integer
last_active_at
required
Last Active At
string format: date-time
last_message_direction
Any of:
string
last_message_preview
Any of:
string
message_count
required
Message Count
integer
outbound_count
required
Outbound Count
integer
peer_id
required
Peer Id
string
platform_channel_id
required
Platform Channel Id
integer
platform_contact_id
Any of:
integer
status
required
Status
string
next_cursor
Any of:
string
prev_cursor
Any of:
string
Example generated
{
  "data": [
    {
      "created_at": "2026-04-15T12:00:00Z",
      "ended_at": "2026-04-15T12:00:00Z",
      "id": 1,
      "inbound_count": 1,
      "last_active_at": "2026-04-15T12:00:00Z",
      "last_message_direction": "example",
      "last_message_preview": "example",
      "message_count": 1,
      "outbound_count": 1,
      "peer_id": "example",
      "platform_channel_id": 1,
      "platform_contact_id": 1,
      "status": "example"
    }
  ],
  "next_cursor": "example",
  "prev_cursor": "example"
}

422

Section titled “422 ”

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Example generated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}