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
{"next_page_token":"\u003cstring\u003e","page_size":"\u003cinteger\u003e","sms_sessions":[{"last_access_time":"\u003cstring\u003e","participants":[{"display_name":"\u003cstring\u003e","owner":{"id":"\u003cstring\u003e","type":"user"},"phone_number":"\u003cstring\u003e","is_session_owner":"\u003cboolean\u003e","extension_status":"deleted","extension_deleted_time":"\u003cstring\u003e"},{"display_name":"\u003cstring\u003e","owner":{"id":"\u003cstring\u003e","type":"user"},"phone_number":"\u003cstring\u003e","is_session_owner":"\u003cboolean\u003e","extension_status":"inactive","extension_deleted_time":"\u003cstring\u003e"}],"session_id":"\u003cstring\u003e","session_type":"\u003cstring\u003e"},{"last_access_time":"\u003cstring\u003e","participants":[{"display_name":"\u003cstring\u003e","owner":{"id":"\u003cstring\u003e","type":"sharedLineGroup"},"phone_number":"\u003cstring\u003e","is_session_owner":"\u003cboolean\u003e","extension_status":"inactive","extension_deleted_time":"\u003cstring\u003e"},{"display_name":"\u003cstring\u003e","owner":{"id":"\u003cstring\u003e","type":"sharedLineGroup"},"phone_number":"\u003cstring\u003e","is_session_owner":"\u003cboolean\u003e","extension_status":"inactive","extension_deleted_time":"\u003cstring\u003e"}],"session_id":"\u003cstring\u003e","session_type":"\u003cstring\u003e"}]}