List SMS conversations | Saperly Docs

const url = 'https://saperly.com/api/v1/conversations';
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);
}

{
  "conversations": [
    {
      "line_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "phone_number": "+14155552671",
      "line_phone_number": "+14155550001",
      "message_count": 42,
      "last_message_at": "2024-04-20T16:45:00Z",
      "last_message_text": "Hey, are we still on for the meeting tomorrow?",
      "last_message_direction": "inbound"
    }
  ],
  "has_more": true,
  "next_cursor": "2024-04-20T16:45:00Z"
}

Returns conversation threads grouped by line and phone number, ordered by most recent message. 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.

Query parameters

line_idstringOptionalformat: "uuid"

Filter by line ID

limitintegerOptional1-100Defaults to 20

Maximum number of results (1-100)

cursordatetimeOptional

ISO 8601 timestamp cursor for pagination

Response

List of conversations

conversationslist of objects

has_moreboolean

next_cursordatetime or null

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error