conversations

List a conversation's messages

Changed on

Returns one page of a conversation's messages, both directions, newest first by default (order_by created_at asc reads it oldest first, as a thread shows it). Each message has its full body.

get/conversations/{conversation_id}/messages

Request

Path parameters

conversation_idstring uuid required

conversation identifier

Query parameters

limitinteger

max items per page

offsetinteger

pagination offset

order_bystring

Sort expression 'created_at [asc|desc]': when the platform stored each message, newest first by default.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

totalinteger required

Total messages matching the query.

Example response

{
  "$schema": "/api/v1/PhoneMessageListResponse.json",
  "messages": [
    {
      "$schema": "/api/v1/PhoneMessage.json"
    }
  ]
}

Changes