Retrieve message details

Retrieves an MDR (Message Detail Record).

An MDR describes a specific message request - both the active/pending and completed request. We store the most recent version of its MDR.

Related:

  • Messaging Overview: Looking up Messaging Detail Records discusses MDRs in far more detail
  • Reports (MDR) API endpoints
Request
path Parameters
sms_id
required
string

ID of message [request]

Responses
200

Current MDR

get/messages/{sms_id}
Request samples
Response samples
application/json
{
  • "sms_id": "c51c89d9-68ad-4db2-a471-cf622d21c40d",
  • "sms_gw_id": "c51c89d9-68ad-4db2-a471-cf622d21c40d",
  • "user_id": "834f3d53-8a3c-4aa0-a733-7f2d682a72df",
  • "profile_id": "16fd2706-8baf-433b-82eb-8c7fada847da",
  • "body": {
    },
  • "status": "sending",
  • "delivery_status": "success",
  • "created": 1522097596060,
  • "updated": 1522097596753,
  • "date_created": "2018-03-26T20:53:16.060000",
  • "date_updated": "2018-03-26T20:53:16.753000",
  • "from": "+13125550001",
  • "to": "+13125550001",
  • "direction": "inbound",
  • "on_net": true,
  • "cost": "0.00450",
  • "currency": "USD",
  • "type": "SMS = text message"
}