List SMS logs

GET {{baseUrl}}/contact_center/sms?next_page_token=<string>&page_size=10&from=<date>&to=<date>&country_iso_codes=<string>&country_iso_codes=<string>&direction=outbound&user_id=<string>&engagement_id=<string>&consumer_number=<string>

Returns a list of SMS.

Scopes: contact_center_sms:read:admin

Rate Limit Label: HEAVY

Request Params

KeyDatatypeRequiredDescription
next_page_tokenstringUse the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.
page_sizenumberThe number of items returned per page.
fromstringThe start time and date in yyyy-mm-dd or ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss'Z' or yyyy-MM-dd'T'HH:mm:ss'TZD'). The defined date range should be a month, as the response only includes one month's worth of data. If no start date is specified, return data from the past 24 hours.
tostringRequired only when the from parameter is specified. The end time and date in yyyy-mm-dd or ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss'Z' or yyyy-MM-dd'T'HH:mm:ss'TZD').
country_iso_codesstringTwo-letter country code.
country_iso_codesstringTwo-letter country code.
directionstringThe engagement's direction.
user_idstringThe agent's ID.
engagement_idstringThe engagement's ID.
consumer_numberstringThe consumer's phone number.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;next_page_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;page_size&quot;:10,&quot;total_records&quot;:&quot;\u003cinteger\u003e&quot;,&quot;from&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;to&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;sms&quot;:[{&quot;direction&quot;:&quot;inbound&quot;,&quot;engagement_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;contact_center_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;start_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;end_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;consumer_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;consumer_display_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;queues&quot;:[{&quot;queue_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;queue_name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;queue_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;queue_name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;agents&quot;:[{&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;country_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;sms_types&quot;:[&quot;sms&quot;,&quot;mms&quot;],&quot;total_sent_messages&quot;:&quot;\u003clong\u003e&quot;,&quot;total_received_messages&quot;:&quot;\u003clong\u003e&quot;,&quot;total_sent_files&quot;:&quot;\u003clong\u003e&quot;,&quot;total_received_files&quot;:&quot;\u003clong\u003e&quot;},{&quot;direction&quot;:&quot;inbound&quot;,&quot;engagement_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;contact_center_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;start_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;end_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;consumer_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;consumer_display_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;queues&quot;:[{&quot;queue_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;queue_name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;queue_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;queue_name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;agents&quot;:[{&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;country_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;sms_types&quot;:[&quot;sms&quot;,&quot;mms&quot;],&quot;total_sent_messages&quot;:&quot;\u003clong\u003e&quot;,&quot;total_received_messages&quot;:&quot;\u003clong\u003e&quot;,&quot;total_sent_files&quot;:&quot;\u003clong\u003e&quot;,&quot;total_received_files&quot;:&quot;\u003clong\u003e&quot;}]}