Get account's SMS sessions

GET {{baseUrl}}/phone/sms/sessions?page_size=30&next_page_token=<string>&from=<date>&to=<date>&session_type=user&phone_number=<string>&filter_type=last_message_time

Returns details about SMS sessions for an account.

Prerequisites

  • Paid account
  • User-enabled Zoom phone

Scopes: phone:read:admin , phone_sms:read:admin , phone_sms:read

Granular Scopes: phone:read:list_sms_sessions , phone:read:list_sms_sessions:admin

Rate Limit Label : MEDIUM

Request Params

| Key | Datatype | Required | Description | | page_size | number | | The number of records returned within a single API call. | | next_page_token | string | | The current page number of returned records. | | from | string | | The start time and date in yyyy-mm-dd or yyyy-MM-dd'T'HH:mm:ss'Z' format.

The date range defined by the from and to parameters should be a month as the response only includes one month's worth of data at once.

If unspecified, it returns data from the past 30 days. | | to | string | | This field is required only when the from parameter is specified.

End time and date in yyyy-mm-dd or yyyy-MM-dd'T'HH:mm:ss'Z' format, the same format as the from parameter. | | session_type | string | | This field filters the specific session list by a session type.

The value for this field can be one of the following:
user
call_queue
auto_receptionist
all | | phone_number | string | | The sender's or receiver's phone number that limits the list of SMS sessions. | | filter_type | string | | This field filters by sent_message_time, received_message_time, or last_message_time for the From and To dates.

  • last_message_time: queries which sessions last messages between From and To dates.
  • sent_message_time: queries which sessions have sent messages between From and To dates.
  • received_message_time: queries which sessions have received messages between From and To dates. |

HEADERS

| Key | Datatype | Required | Description | | Accept | string | | |

RESPONSES

status: OK

{&quot;next_page_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;page_size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sms_sessions&quot;:[{&quot;last_access_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;participants&quot;:[{&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;user&quot;},&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_session_owner&quot;:&quot;\u003cboolean\u003e&quot;,&quot;extension_status&quot;:&quot;deleted&quot;,&quot;extension_deleted_time&quot;:&quot;\u003cstring\u003e&quot;},{&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;user&quot;},&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_session_owner&quot;:&quot;\u003cboolean\u003e&quot;,&quot;extension_status&quot;:&quot;inactive&quot;,&quot;extension_deleted_time&quot;:&quot;\u003cstring\u003e&quot;}],&quot;session_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;session_type&quot;:&quot;\u003cstring\u003e&quot;},{&quot;last_access_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;participants&quot;:[{&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;sharedLineGroup&quot;},&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_session_owner&quot;:&quot;\u003cboolean\u003e&quot;,&quot;extension_status&quot;:&quot;inactive&quot;,&quot;extension_deleted_time&quot;:&quot;\u003cstring\u003e&quot;},{&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;sharedLineGroup&quot;},&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_session_owner&quot;:&quot;\u003cboolean\u003e&quot;,&quot;extension_status&quot;:&quot;inactive&quot;,&quot;extension_deleted_time&quot;:&quot;\u003cstring\u003e&quot;}],&quot;session_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;session_type&quot;:&quot;\u003cstring\u003e&quot;}]}