Get Conversation Messages

const url = 'https://api.agentphone.ai/v1/conversations/conversation_id/messages';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "data": [
    {
      "id": "string",
      "body": "string",
      "fromNumber": "string",
      "toNumber": "string",
      "direction": "string",
      "receivedAt": "2024-01-15T09:30:00Z",
      "senderIdentifier": "string",
      "channel": "string",
      "status": "string",
      "failureReason": "string",
      "errorCode": "string",
      "deliveredAt": "2024-01-15T09:30:00Z",
      "deliveredChannel": "string",
      "readAt": "2024-01-15T09:30:00Z",
      "mediaUrl": "string",
      "mediaUrls": [
        "string"
      ],
      "content": {},
      "reactions": [
        {
          "id": "string",
          "reactionType": "string",
          "fromNumber": "string",
          "direction": "string",
          "createdAt": "2024-01-15T09:30:00Z"
        }
      ],
      "replyTo": {
        "messageId": "string",
        "message": "string",
        "mediaUrls": [
          "string"
        ]
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "string"
}

Get paginated messages for a conversation.

Each page is returned oldest-first. Pass the previous response’s nextCursor as cursor to load older history without skipping or repeating records, even when several messages share a timestamp. before/after timestamp filters are still accepted.

Authentication

AuthorizationBearer

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

Path parameters

conversation_idstringRequired

Query parameters

limitintegerOptional1-200Defaults to 50

beforedatetime or nullOptional

afterdatetime or nullOptional

cursorstring or nullOptional

Opaque cursor from a previous response’s nextCursor. Takes precedence over before/after.

Response

Successful Response

datalist of objects

hasMoreboolean

nextCursorstring or nullOptional

Errors

422

Unprocessable Entity Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors