Skip to main content
GET
/
conversations
List conversations
curl --request GET \
  --url https://api.awardee.dev/v1/conversations \
  --header 'Authorization: Bearer <token>'
{
  "object": "<string>",
  "has_more": true,
  "next_cursor": "<string>",
  "data": [
    {
      "object": "<string>",
      "id": "8f3a9d2e-1b4c-4f5d-9e8a-7c3b2a1d0f9e",
      "chatbot_id": "c1f5b2a7-9e8d-4f6a-b3c4-d5e6f7a8b9c0",
      "title": "Refund question",
      "summary": "Visitor asked about refund window. Bot escalated to human.",
      "sentiment_score": 72,
      "contact_email": "[email protected]",
      "contact_name": "Ada Lovelace",
      "contact_phone": "+1 415 555 0143",
      "assigned_to": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "last_message_preview": "<string>",
      "last_message_at": "2023-11-07T05:31:56Z",
      "resolved_at": "2023-11-07T05:31:56Z",
      "closed_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "qr_code_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

Authorizations

Authorization
string
header
required

Send your API key as Authorization: Bearer aw_live_…. Manage keys in the dashboard under Settings → API Keys.

Query Parameters

cursor
string
limit
integer
Required range: 1 <= x <= 100
chatbot_id
string<uuid>
status
string

Comma-separated status values

priority
string

Comma-separated priority values

assigned_to
string

Comma-separated user ids

include_unassigned
enum<string>
Available options:
true,
false
sort
string

Response

Conversations

object
string
required
Allowed value: "list"
has_more
boolean
required
next_cursor
string | null
required
data
object[]
required