Get transaction status

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.
231	Invalid/unsupported	Invalid/unsupported message content
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.	Telesign successfully delivered the message through our gateway and it passed downstream. However, Telesign did not receive a delivery receipt within 12 hours of transmission. We cannot confirm delivery to the handset. The end user most likely did not receive the message.
290	Message in progress	The message is being sent to the SMS gateway.
292	Queued by gateway	The SMS gateway has queued the message.
295	Status delayed	The status of the SMS is temporarily unavailable.
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.
517	Selected DLT details for India not supported	The DLT template ID or entity ID in the request cannot be found by the end operator.
520	Content sent is not allowed	The content in this message is not permitted by the carrier.
521	Requested Sender ID is not allowed for destination	The sender ID submitted in request is not allowed in destination country/operator.

Status code	Associated Text String
10002	'x-ts-nonce' header value has been used recently
10003	'x-ts-nonce' header value is either too long or too short
10004	'Date' or 'x-ts-date' header is not within tolerable range
10005	Date' or 'x-ts-date' header is not RFC822 compliant
10006	Invalid 'x-ts-auth-method' header.
10007	Missing required 'Date' or 'x-ts-date' header
10008	Invalid Signature.
10009	Missing required 'Authorization' header
10010	CustomerID Account Suspended.
10011	This product is not enabled for this CustomerID.
10013	CustomerID Account Not Found
10014	Invalid source IP address.
10015	Invalid Customer ID.
10022	Invalid API Key.
10028	Required 'Authorization' header is not in the correct format
10031	Not Allowed Host
10035	The requested API host is not allowed for this CustomerID.

Status code	Description
10017	Customer ID / Reference ID not found
10036	Reference ID expired

404 Not Found, the server has not found anything matching the Request-URI. 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 codeDescription10017Customer ID / Reference ID not found10036Reference ID expired

429Too Many Requests, the user sent too many requests in a given amount of time. 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 codeAssociated text string10019Rate Limit Exceeded