DealerAI
API Reference

Get Conversation by ConversationId

Retrieves conversation data including user information, status, and optionally messages for the specified conversation ID.

GET
/api/v1/conversation/{conversationId}

Authorization

basic
AuthorizationBasic <token>

Basic Authorization header

In: header

Path Parameters

conversationId*string

The unique identifier for the conversation.

Query Parameters

includeMessages?boolean

Optional flag to include conversation messages in the response. Default is false.

Defaultfalse

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.dealerai.com/api/v1/conversation/string"
{
  "conversation_id": "string",
  "dealer_id": "string",
  "channel": "string",
  "contact_info": {
    "full_name": "string",
    "email": "string",
    "phone": "string"
  },
  "is_likely_spam": true,
  "flag": [
    "string"
  ],
  "is_archived": true,
  "status": "string",
  "is_adf": true,
  "message_count": 0,
  "created_date": "2019-08-24T14:15:22Z",
  "last_online_date_time": "2019-08-24T14:15:22Z",
  "last_modified_date": "2019-08-24T14:15:22Z",
  "messages": [
    {
      "role": "string",
      "text": "string",
      "attachments": [
        {
          "content_type": "string",
          "content_url": "string",
          "content": null,
          "name": "string"
        }
      ],
      "date_created": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}

Get a single chat conversation by id.

Read-only endpoint for fetching one chat conversation and optionally its messages.

Get Conversations with Filtering and Pagination

Retrieves a paginated list of conversations for the authenticated dealership with optional filtering by channel, status, dates, and archived status. Results are ordered by LastModifiedDate.