Get user's SMS sessions

GET {{baseUrl}}/phone/users/:userId/sms/sessions?page_size=30&next_page_token=nav48KOj42vYPSG4f0cCdT575bZ980did22&from=2021-12-01&to=2021-12-31&phone_number=18108001001

Get details about SMS sessions for a user. For user-level apps, pass the me value instead of the userId parameter.

Scopes: phone_sms:read, phone_sms:read:admin, phone_sms:master

Rate Limit Label: Heavy

Prerequisites: * Paid account * User-enabled Zoom phone

Request Params

KeyDatatypeRequiredDescription
page_sizenumberThe number of records returned within a single API call.
next_page_tokenstringThe current page number of returned records.
fromstringStart 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, returns data from the past 30 days.
tostringRequired 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.
phone_numbernumberEither the sender's or receiver's phone number, to limit the list of SMS sessions.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"next_page_token":"2z0Ov7kngllAbfQi4ZR2eQTb3mFVYQpYAe4","page_size":30,"sms_sessions":[{"last_access_time":"2022-03-25T02:11:27Z","participants":[{"display_name":"l api","owner":{"id":"DnEopNmXQEGU2uvvzjgojw","type":"user"},"phone_number":"18108001001"},{"display_name":"l api","owner":{"id":"DnEopNmXQEGU2uvvzjgojw","type":"user"},"phone_number":"18108001001"}],"session_id":"d39fc7e14ef9f2b6453f5f02524d79a2"},{"last_access_time":"2022-03-25T02:11:27Z","participants":[{"display_name":"l api","owner":{"id":"DnEopNmXQEGU2uvvzjgojw","type":"user"},"phone_number":"18108001001"},{"display_name":"l api","owner":{"id":"DnEopNmXQEGU2uvvzjgojw","type":"user"},"phone_number":"18108001001"}],"session_id":"d39fc7e14ef9f2b6453f5f02524d79a2"}]}