Get Message Detail Records
This request returns a list of received and sent messages with their detailed information.
get | /sms/message_drs |
Sample
A sample GET request to get a list of received and sent messages and their detailed information:
curl -X GET \
'https://api.carrierx.com/core/v2/sms/message_drs?after=b6d574ea-b11f-41fd-a25f-602e7b28807f&limit=1' \
-H 'Authorization: Bearer 5ebc03d6-8b2b-44ad-bf65-72d4f1491dda'
Response
200
status code with a list of SMS Detail Record objects:
{
"count": 1,
"has_more": true,
"items": [
{
"a2p_campaign": null,
"date_changed": "2025-04-14T10:32:18.175Z",
"date_insert": "2025-04-14T10:32:17.279Z",
"date_sent": "2025-04-14T10:32:17.997Z",
"date_start": "2025-04-14T10:32:17.279Z",
"date_stop": "2025-04-14T10:32:00.000Z",
"delay_sent": 0,
"direction": "outbound",
"dr_sid": "92cd9154-2f53-4e62-8b4e-8ff6e4849d16",
"mcc": 310,
"mcc_mnc_price": "0.015",
"mcc_mnc_rate": "0.005",
"media_urls": [
"https://storage.carrierx.com/f/cdac0471-f144-42a2-94f8-d9838ce5e4b9"
],
"message": null,
"message_segments": 1,
"mnc": 999,
"number_billing": "12078152557",
"number_dst": "17575000929",
"number_external": "17575000929",
"number_group_dst": [
"17207217011",
"17207210038",
"17575000929"
],
"number_src": "12078152557",
"p2p_nnid": null,
"partner_sid": "8d180104-0b34-4e55-907f-4a72409484c9",
"passthrough_price": null,
"passthrough_rate": null,
"price": "0.015",
"provider": "tsg",
"rate": "0.005",
"registration_type": null,
"status": "sent",
"type": "mms",
"user_data": "test_message",
"vendor_error_code": "503",
"version": null
}
],
"limit": 1,
"offset": 0,
"pagination": {
"previous": "https://api.carrierx.com/core/v2/sms/message_drs?before=92cd9154-2f53-4e62-8b4e-8ff6e4849d16&limit=1&offset=0"
},
"total": null
}
This request is enabled for Pagination (including after
and before
parameters), Result Filtering, and Field Filtering.
If used with after
or before
pagination, you can sort the response results by the SMS Detail Record object date_insert
attribute only (order=date_insert+asc
or order=date_insert+desc
).
Required Scopes
To get information about SMS Detail Record objects, the partner must have one of the following scopes enabled:
sms.manage
sms.read
To view information about SMS Detail Record objects for the inherited partners, the partner must additionally have the sms.read_descendant
scope enabled.