Get messages in a conversation

const url = 'https://saperly.com/api/v1/conversations/lineId/%2B15551234567';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "messages": [
    {
      "direction": "inbound",
      "text": "Hey, are we still on for the meeting at 3 PM?",
      "timestamp": "2024-01-15T09:30:00Z"
    },
    {
      "direction": "outbound",
      "text": "Yes, I'll be there. See you soon!",
      "timestamp": "2024-01-15T09:32:00Z"
    },
    {
      "direction": "inbound",
      "text": "Great, looking forward to it.",
      "timestamp": "2024-01-15T09:33:45Z"
    }
  ],
  "has_more": true,
  "next_cursor": "2024-01-15T09:33:45Z"
}

Returns individual SMS messages in a conversation between a line and a phone number. Supports cursor-based pagination.

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Path parameters

lineIdstringRequiredformat: "uuid"

Line ID

phoneNumberstringRequired

E.164 phone number of the other party

Query parameters

limitintegerOptional1-100Defaults to 50

Maximum number of results (1-100)

cursordatetimeOptional

ISO 8601 timestamp cursor for pagination

Response

List of messages

messageslist of objects

has_moreboolean

next_cursordatetime or null

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error