Use this endpoint to retrieve a list of Message Detail Records (MDRs) within a specified date range. Date and time is based on Coordinated Universal Time (UTC).
All parameters are optional except where noted.
The beginning date and time, in UTC, on which to perform an MDR search. The DateTime can be formatted as YYYY-MM-DDor YYYY-MM-DDTHH:mm:ss.SSZ.
The ending date and time, in UTC, on which to perform an MDR search. The DateTime can be formatted as YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSZ.
The number of MDRs to retrieve at one time. You can set as high of a number as you want, but the number cannot be negative and must be greater than 0 (zero).
The number of MDRs to skip when performing a query. The number must be 0 (zero) or greater, but cannot be negative.
Response FormatOn success, the HTTP status code in the response header is 200 OK and the response body contains an array of message objects in JSON format. On error, the header status code is an error code and the response body contains an error object.
dataarray of objects
An array of message objects that satisfy your query individually composed of:
Object composed of attributes defined in Receive an MMS.
The start_date and end_date parameters accept UTC DateTime strings formatted in accordance with ISO 8601. These parameters can be as general as YYYY-MM-DD—for example, 2016-12-30; or, as specific as YYYY-MM-DDTHH:mm:ss.SSZ—for example, 2016-12-30T14:34:01.321Z.
HTML URL Encoding
ISO 8601 utilizes two characters that must be HTML URL encoded. These characters, and their related URL-encoded formats, are:
- : (colon), encoded as %3A
- + (plus), encoded as %2B