get
/messaging/{reference_id}
By passing the reference ID for a transaction in the body of your request, you can receive a response containing details about that transaction. NOTE: If you try this API out using the API Explorer, you will be billed for the transaction as you normally would.
All requests submitted for the SMS API:
Request Parameters
1 Path Parameter
Responses
Your request was fulfilled and resulted in a new resource being created. If you want to code against a response, you should retrieve the status or error code and use that rather than the HTTP status response.
Status Code | Associated Text String | Description |
---|---|---|
200 | Delivered to handset | The SMS was delivered to the end user’s phone. (Final) |
203 | Delivered to gateway | The SMS was delivered to the gateway. If the gateway responds with further information (including successful delivery to handset or delivery failure), the status is updated. (Intermediate) |
207 | Error delivering SMS to handset (reason unknown) | The SMS could not be delivered to the end user’s handset for an unknown reason. (Final) |
210 | Temporary phone error | The SMS could not be delivered to the handset due to a temporary error with the phone. Examples - phone is turned off, not enough memory to store the message. (Final) |
211 | Permanent phone error | The SMS could not be delivered to the handset due to a permanent error with the phone. For example, the phone is incompatible with SMS, or illegally registered on the network. This can happen when a phone number is blacklisted, or is incorrectly provisioned. (Final) |
220 | Gateway/network cannot route message | The network cannot route the message to the handset. (Final) |
221 | Message expired before delivery | The message was queued by the mobile provider and timed out before it could be delivered to the handset. (Final) |
222 | SMS not supported | SMS is not supported by this phone, carrier, plan, or user. |
230 | Message blocked by TeleSign | TeleSign blocks a message if it is being sent to a phone number that is on a global blocklist. |
231 | Invalid/unsupported | The content of the message is not supported. |
237 | Message blocked in requested country | You requested that messages in a specific country be blocked, and the message was being sent to this country. |
238 | Destination blocked by prefix | You requested that phone numbers with a particular prefix be blocked. |
250 | Final status unknown | The final status of the SMS cannot be determined. |
251 | Message successfully sent out for delivery, however final confirmation of delivery to handset was not received | This message was successfully delivered to the gateway, but TeleSign cannot confirm delivery to the handset because TeleSign does not receive the final handset DLR in this region. NOTE: There is a high probability that this message was successfully delivered to the handset. |
286 | Transaction not attempted | The SMS is blocked from being sent due to the phone type not being one of the following - mobile, prepaid, personal, or pager. |
290 | Message in progress | The message is being sent to the SMS gateway. |
291 | Queued by TeleSign | TeleSign is experiencing an unusually high volume and has queued the SMS message. |
292 | Queued by gateway | The SMS gateway has queued the message. |
295 | Status delayed | The status of the SMS is temporarily unavailable. |
500 | Transaction not attempted | No SMS request was attempted. |
502 | Campaign error | This error can be generated if there is a problem with the short code used. |
503 | Carrier rejected - temporary problem | This error is generated if there is an error on the carrier or operator side that is temporary and the message can be retried. |
504 | Carrier rejected - permanent error | This error is generated if there is an error on the carrier or operator side that is permanent and the message should not be retried. |
505 | Error on gateway - temporary error | This error is generated if there is an error on TeleSign’s partner side that is considered temporary and the message can be retried. |
506 | Error on gateway - permanent error | This error is generated if there is an error on TeleSign’s partner side that is considered permanent and the message should not be retried. |
507 | Invalid destination address | There is a problem with the destination address used. Either the format is not valid, or the number is not associated with any carrier, or if MSC is used it does not know about this MSISDN. |
508 | Invalid source address | The message requires a source address. Verify that one is provided and correct. |
509 | Parameters problem | One or more parameters used in the request is not supported. |
510 | Message blocked by subscriber action or request | The end user has blocked receiving SMS with their carrier plan or by request or from the particular short code used. |
511 | Subscriber low on credit | The end user exceeded their spending limits and cannot receive SMS. |
512 | Roaming error | End user cannot receive SMS because their device that receives the messages is roaming. |
513 | Mobile number portability error | SMS failed because ported combinations are unreachable. |
514 | Subscriber absent | The operator/carrier is temporarily unable to reach the end user. |
515 | Suspected spam | This message is considered to be spam by carrier or operator. |
599 | Status not available | The system is unable to provide status at this time. |
Schema
reference_id
string
A 32-digit hex value used to identify the web service request. The value is unique to each web service request, is randomly generated by TeleSign, and is returned in the response message immediately following the web service request.
status
object
Send a Test Request
GET
Send requests directly from the browser (CORS must be enabled)
Path Params
1 path param not set
reference_id
$$.env
1 variable not set
host