Skip to main content

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.

note

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.