C
Chatty

List Conversations

GET/api/v1/conversations

Returns messages across all conversation sessions, newest first. Use GET /api/v1/conversations/{session_id} to fetch a single thread.

Required scope: read

Query parameters

limitintegerquerydefault: 50
Number of messages. Min 1, max 200.
offsetintegerquerydefault: 0
Zero-based offset.

Response

messagesarray

Array of messages with id, session_id, role ("user" or "assistant"), content, feedback_rating, created_at.

limitinteger
Limit used.
offsetinteger
Offset used.

Example

cURL
curl "https://api.personaliai.com/api/v1/conversations?limit=50" \
  -H "Authorization: Bearer chatty_sk_your_key"

200 OK:

{
  "messages": [
    {
      "id": "msg-uuid-001",
      "session_id": "visitor-xyz-789",
      "role": "assistant",
      "content": "You're welcome! Is there anything else I can help with?",
      "feedback_rating": "up",
      "created_at": "2026-07-06T14:25:00Z"
    }
  ],
  "limit": 50,
  "offset": 0
}