Sign in
SMS

List SMS logs

Returns a cursor-paginated list of SMS log entries for your organization, newest first. Entries contain delivery metadata (direction, phone numbers, timestamps) — message bodies are not stored.

get/v2/sms-logs

Query parameters

page_sizeinteger

Number of records per page (default 50, max 100).

cursorstring

Opaque pagination cursor returned by the previous response.

direction'inbound' | 'outbound'

Filter by message direction.

from_numberstring

Filter by sender phone number (partial match).

to_numberstring

Filter by recipient phone number (partial match).

from_datestring date-time

Filter messages logged on or after this ISO 8601 timestamp.

to_datestring date-time

Filter messages logged on or before this ISO 8601 timestamp.

Response

Paginated list of SMS log entries.

has_moreboolean required

Whether more records exist after this page.

next_cursorstring

Opaque cursor to pass as cursor in the next request.

Example response

{
  "sms_logs": [
    {
      "id": 42,
      "from_number": "+16625658792",
      "to_number": "+17189153182"
    }
  ]
}

Changes

Changed in 1 of the 2 revisions of this API.1