Note: Status reports can be routed back to you via HTTP, which is the preferred way for you to receive status reports.

This API call may be useful to you, however, if you are not permanently connected to the Internet, but still need to be able to query for status reports.

URL: http://usa.bulksms.com:7512/eapi/1.0/get_report.mc

Example: http://usa.bulksms.com:7512/eapi/1.0/get_report.mc?username=john&password=abcd1234&msg_id=123456

Required parameters

• username
• password
• msg_id: the id returned by a successful submission to send_sms

Optional parameters

• msisdn: supply if querying the status of a single recipient.

Returns on failure:

request_status_code|request_status_description

values for status_code are:

• 23: Authentication failure
• 24: Data validation failed
• 1001: Error - message not found

Returns on success:

1000|Results to follow\n\n Followed by one or more newline-separated items in the format:
msisdn|status_code|status_description

values for status_code are:

• 0: In progress (a normal message submission, with no error encountered so far).
• 10: Delivered upstream
• 11: Delivered to mobile
• 12: Delivered upstream unacknowledged (assume message is in progress)
• 22: Internal fatal error
• 23: Authentication failure
• 24: Data validation failed
• 25: You do not have sufficient credits
• 26: Upstream credits not available
• 27: You have exceeded your daily quota
• 28: Upstream quota exceeded
• 29: Message sending cancelled
• 30: Test complete (you should never see this)
• 40: Temporarily unavailable
• 50: Delivery failed - generic failure
• 51: Delivery to phone failed
• 52: Delivery to network failed
• 53: Message expired
• 60: Transient upstream failure (transient)
• 61: Upstream status update (transient)
• 62: Upstream cancel failed (transient)
• 70: Unknown upstream status