List conversations (all channels)
GET/api/v1/messages/conversations
Retrieve your conversations on every channel, newest activity first. A conversation is everything sent to and received from one phone number, whether it went by SMS or RCS. latestChannel tells you which channel the latest message used.
If your account doesn't use RCS, everything here is SMS: latestChannel always reads sms, and the RCS parts don't apply to you.
This is the all-channel version of List conversations, which covers SMS only. It takes the same parameter and pages the same way: up to 200 conversations per page, with page.
A few things differ from the SMS-only endpoint:
- RCS messages are counted. MMS messages are not.
- Group sends are counted. A group send is a message you send to a contact list: everyone on the list gets their own copy, and that copy counts as one message in their conversation.
- A number that has only received group sends isn't listed until it replies or you send it a message of its own.
- Each conversation has
latestChannel. - The response has no
statusText.
To read the messages in a conversation, use Get conversation (all channels).
Request
Query Parameters
Specify the page number of results you want to retrieve. Each page holds up to 200 conversations. If you don´t provide a page number, the API will return the first page by default.
Responses
- 200
- 401
- 500
The list of conversations was successfully retrieved.
Unauthorized.
The conversations could not be read. Try again.