---
title: "Get conversations for a chatbot"
method: GET
path: "/get-conversations"
tags: ["Conversations"]
---

# Get conversations for a chatbot

`GET /get-conversations`

Retrieves conversation history for a specific chatbot

## Query parameters

- `chatbotId` string, required
- `filteredSources` string
- `startDate` string, date
- `endDate` string, date
- `page` string
- `size` string

## Response `200`

Conversations retrieved successfully

- object
  - `data` Conversation[]
    - `id` string — Unique conversation identifier
    - `chatbot_id` string — Associated chatbot ID
    - `created_at` string, date-time — Conversation start time
    - `updated_at` string, date-time — Last message time
    - `source` 'api' | 'website' | 'whatsapp' | 'slack' | 'messenger' | 'instagram' — Conversation source
    - `messages` ChatMessage[] — Messages in the conversation
      - `id` string — Unique message identifier
      - `role` 'user' | 'assistant', required — Message sender role
      - `content` string, required — Message content
      - `type` 'text' — Message type

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error

---

[API](https://skmtc.dev/chatbase/apis/chatbase-api-v1.md) · [All operations](https://skmtc.dev/chatbase/apis/chatbase-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chatbase/chatbase-api-v1/revisions/3a2187967746/schema)