Skip to main content
GET
/
get-conversations
Get conversations for a chatbot
curl --request GET \
  --url https://www.chatbase.co/api/v1/get-conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "conv_123",
      "chatbot_id": "ckl123abc456",
      "created_at": "2024-01-01T12:00:00Z",
      "updated_at": "2024-01-01T12:05:00Z",
      "source": "api",
      "messages": [
        {
          "id": "msg_123",
          "role": "user",
          "content": "Hello, I need help with my order",
          "type": "text"
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

API key in Bearer token format

Query Parameters

chatbotId
string
required

ID of the chatbot

filteredSources
string

Comma-separated list of conversation sources to filter by. Example API,WhatsApp,Messenger,Instagram,Slack,Playground,Action preview,Widget or Iframe

startDate
string<date>

Start date for conversation filtering (YYYY-MM-DD)

endDate
string<date>

End date for conversation filtering (YYYY-MM-DD)

page
string

Page number for pagination

size
string

Number of items per page

Response

Conversations retrieved successfully

data
object[]
I