I'm using the Fuel REST API postMessageContactSend method to send an SMS to a subscriber. I receive the following response for my request:

   "tokenId": "MTFjQjgzV2VFa2Vlcks5VnZadkhuQTo3OTow"

I then include this tokenId value as a parameter in the getMessageContactDelivery method to check the delivery status of the SMS. I receive the following response:

   "message":"this is the message text",
         "message":"Transaction completed"

The question is, does "statusCode":"0" mean the SMS is delivered? If so, can I assume that if "status":"Finished" and statusCode > 0, then the SMS could not be delivered?


Unfortunately, you cannot get whether an SMS message has actually been delivered. You're essentially seeing whether the hand off to the carrier has been successful, but once the handoff happens, the SFMC has no way of knowing the status of the message.

  • Hello Timothy, I'm just trying to use this method as an alternative to manually downloading a MobileConnect report. This report shows whether the message was delivered to a mobile device or if it was undelivered (for example, the mobile device has moved out of its service area). Are you saying that this delivery reports are only available by manually downloading reports from MobileConnect? – Eliot Harper Feb 17 '15 at 22:17
  • 1
    Not quite. We don't actually know for sure, even in that report. I've asked around to verify. What is actually happening: we do a call to the carriers, and if there is no error, we assume delivered (which is actually a pretty good assumption). But absolute verification without assumptions does not exist. – Timothy Feb 18 '15 at 16:10
  • I've found a list of some MobileConnect status codes which may be helpful for others when checking the message status. – Eliot Harper Feb 22 '15 at 17:14

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.