Get Conversation by Participants

Find a conversation by source DID and participant numbers

GET /v2/messaging/conversations/conversation-by-participants

Get Conversation by Participants

cURL

curl --request GET \
  --url https://api.voxo.co/v2/messaging/conversations/conversation-by-participants \
  --header 'Authorization: Bearer <token>'

200

{
  "id": 123,
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "sourceDID": "<string>",
  "participants": "<string>",
  "tenantId": 123,
  "hidden": 123,
  "name": "<string>",
  "conversationName": "<string>",
  "unreadCount": 123,
  "lastMessageId": 123
}

Authorizations

Authorization · string · header · required

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

Query Parameters

from · string · required

Source DID number (10 digits)

to · string · required

Comma-separated recipient numbers (10 digits)

Response

200

application/json

Matching conversation

id · number · required

Conversation ID

createdAt · string | null · required

Created timestamp

updatedAt · string | null · required

Last updated timestamp

sourceDID · string · required

Source DID number

participants · string · required

Comma-separated participant numbers

tenantId · number · required

Tenant ID

hidden · number | null · required

Whether conversation is hidden (1/0)

name · string | null · required

Auto-generated conversation name

conversationName · string | null · required

User-assigned conversation name

unreadCount · number | null · required

Unread message count

lastMessageId · number | null · required

Last message ID