Skip to main content
GET
https://api.sitespeak.ai
/
v1
/
{chatbot_id}
/
conversations
curl -X GET "https://api.sitespeak.ai/v1/{chatbot_id}/conversations?limit=10&order=desc&include_sources=true" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Path Parameters

NameTypeDescription
chatbot_id*StringThe ID of your chatbot. You can find the ID on the settings page for your chatbot.

​
Headers

NameTypeDescription
Authorization*StringBearer

​
Query Parameters

NameTypeDescription
conversation_idStringReturn only conversations with this conversation_id (visitor).
include_deletedBooleanInclude conversations that have been cleared in the response. Default: False.
include_sourcesBooleanInclude sources that were used by your bot for each conversation when available. Default: False.
limitIntegerLimit the number of conversations returned. Default: 10.
orderStringSort order for the conversation history returned. Can be either “asc” or “desc”. Default: “asc”.
curl -X GET "https://api.sitespeak.ai/v1/{chatbot_id}/conversations?limit=10&order=desc&include_sources=true" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Response

[
  {
    "id": "f72caccf-40b7-4b17-9b20-b314cfcb3f21",
    "chatbot_id": "7878ffe5-d785-48d6-8113-23eaa4ed2c39",
    "visitor_id": "100753748e9cefddb50e9fca5dd59295",
    "thread_id": null,
    "entry": "SnapWidget is a platform that allows you to automatically display your Instagram, Twitter, Facebook, and YouTube content on your website.",
    "speaker": "bot",
    "avatar": null,
    "status": "read",
    "feedback": null,
    "category_id": null,
    "created_at": "2024-06-04 11:42:29",
    "updated_at": "2024-06-04 11:42:29",
    "deleted_at": null
  },
  {
    "id": "581b2dc1-3e54-4188-8c4c-2442c8891ec3",
    "chatbot_id": "7878ffe5-d785-48d6-8113-23eaa4ed2c39",
    "visitor_id": "100753748e9cefddb50e9fca5dd59295",
    "thread_id": null,
    "entry": "Please provide a short overview of what SnapWidget is?",
    "speaker": "user",
    "avatar": null,
    "status": "read",
    "feedback": null,
    "category_id": null,
    "created_at": "2024-06-04 11:42:25",
    "updated_at": "2024-06-04 11:42:25",
    "deleted_at": null,
    "sources": []
  }
]
Last modified on January 22, 2026