Skip to main content
GET
/
conversations
List available conversations.
curl --request GET \
  --url https://1-some-client.some-server.healvi-chat/third-party/v1/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "created_at": "2023-01-01T12:00:00Z",
      "channel": "bridge",
      "status": "to-do",
      "snooze_until": "2023-01-01T12:00:00Z",
      "agent": {
        "id": 123,
        "channel": "bridge",
        "display_id": 4915223567929,
        "name": "John Doe",
        "in_sync": true,
        "unread_conversations_count": 123
      },
      "customer": {
        "id": 123,
        "channel": "bridge",
        "display_id": 4915223567929,
        "name": "John Doe",
        "profile": {
          "id": 123,
          "salutation": "formal_male",
          "name": "John Doe",
          "gender": "undisclosed",
          "blocked": true,
          "date_of_birth": "1970-01-01",
          "phone_number": "+4915224367929",
          "email": "jsmith@example.com",
          "address": "<string>",
          "custom_1": "<string>",
          "custom_2": "<string>",
          "custom_3": "<string>",
          "custom_4": "<string>",
          "custom_5": "<string>",
          "created_at": "2023-01-01T12:00:00Z",
          "updated_at": "2023-01-01T12:00:00Z"
        }
      },
      "user": {
        "id": 123,
        "name": "<string>",
        "email": 123,
        "roles": [
          "<string>"
        ],
        "permissions": [
          "<string>"
        ],
        "created_at": "2023-01-01T12:00:00Z",
        "updated_at": "2023-01-01T12:00:00Z"
      },
      "latest_message": {
        "id": 123,
        "conversation_id": 123,
        "from": "system",
        "source": "user",
        "user_id": 123,
        "contents": [
          {
            "type": "text",
            "content": "<string>"
          }
        ],
        "status": "created",
        "agent_reaction": "<string>",
        "customer_reaction": "<string>",
        "sent_at": "2023-01-01T12:00:00Z",
        "reference": {},
        "latest_error": {
          "id": 123,
          "message_id": 123,
          "type": "status-update",
          "original_message": "<string>",
          "created_at": "2023-01-01T12:00:00Z"
        },
        "whatsapp_campaign": {
          "id": 123,
          "name": "<string>"
        }
      },
      "latest_customer_message": {
        "id": 123,
        "conversation_id": 123,
        "from": "system",
        "source": "user",
        "user_id": 123,
        "contents": [
          {
            "type": "text",
            "content": "<string>"
          }
        ],
        "status": "created",
        "agent_reaction": "<string>",
        "customer_reaction": "<string>",
        "sent_at": "2023-01-01T12:00:00Z",
        "reference": {},
        "latest_error": {
          "id": 123,
          "message_id": 123,
          "type": "status-update",
          "original_message": "<string>",
          "created_at": "2023-01-01T12:00:00Z"
        },
        "whatsapp_campaign": {
          "id": 123,
          "name": "<string>"
        }
      },
      "last_customer_reply_from": "2023-01-01T12:00:00Z",
      "latest_note": {
        "id": 123,
        "conversation_id": 123,
        "text": "<string>",
        "created_at": "2023-01-01T12:00:00Z",
        "updated_at": "2023-01-01T12:00:00Z"
      },
      "unread_customer_messages_count": 123,
      "reply_until": "2023-01-01T12:00:00Z",
      "reply_possible": true,
      "customer_interaction_required": true
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "current_page": 123,
    "from": 123,
    "to": 123,
    "last_page": 123,
    "per_page": 123,
    "total": 123,
    "path": "<string>",
    "links": [
      "<any>"
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

status
enum<string>

Optional status of conversations.

Available options:
to-do,
in-progress,
done
channel
enum<string>

Optional channel of conversations.

Available options:
bridge,
whatsapp,
widget
order_by_latest_message
integer

Optional flag to order conversations by their latest message sent_at field (desc).

Example:

1

hide_empty
integer

Optional flag to hide conversations which have no messages.

Example:

1

per_page
integer

Optional number of conversations per page.

Response

200 - application/json

Success

data
object[]

Default count: 100

meta
object