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": [
        {
          "role": "user",
          "content": "Hello, I need help with my order",
          "id": "msg_123",
          "type": "text"
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt

Use this file to discover all available pages before exploring further.

Looking for API v2? The new Chatbase API v2 features structured error codes, cursor-based pagination, and SSE streaming. Check out the API v2 Reference →

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[]