Docs
Growth

List demo conversations (leads)

GET/ai/conversationsNeedscontent.edit

Every conversation the demo agent had, newest first, with the lead's email, AI review and booking state.

Authorization

secretKey
headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Query Parameters

filter?string

Bucket.

Value in"all""qualified""unqualified""unreviewed"
q?string

Search goal, summary, email and visitor.

limit?integer

Page size (1–200).

Range1 <= value <= 200
offset?integer

Rows to skip.

Range0 <= value

Response Body

OK

application/json
  1. response
conversations*array<>
total*integer
counts*
limit*integer
offset*integer
Shell
curl -X GET 'https://app.cueston.com/api/ai/conversations'
Example Response
JSON
{
  "conversations": [
    {
      "sessionId": "sess_4b1e7a20",
      "goal": "string",
      "steps": 0,
      "outcome": "done",
      "qualified": "true",
      "userId": "user-123",
      "visitorId": "string",
      "email": "ada@acme.com",
      "name": "Ada Lovelace",
      "createdAt": "2026-10-26T09:30:00Z",
      "updatedAt": "2026-10-26T09:30:00Z",
      "bookingOpenedAt": "2026-10-26T09:30:00Z",
      "bookedAt": "2026-10-26T09:30:00Z"
    }
  ],
  "total": 3,
  "counts": {
    "all": 0,
    "qualified": 0,
    "unqualified": 0,
    "unreviewed": 0
  },
  "limit": 0,
  "offset": 0
}