Get delivery status and other details for a Telesign SMS Verify API transaction that you have created. Use this endpoint also to complete verification, if Telesign generated your code.
General requirements
Authentication:Basic (easiest to implement) or Digest
Encoding: Accepts only UTF-8 unicode characters as inputs.
Bad request. The request could not be understood by the server due to malformed syntax. Code against the Telesign status or error codes from the status.code and errors.code properties in the response payload, rather than the HTTP status code of the response.
Associated text string for -10001 will change depending on the parameter.
401
Unauthorized. The request requires user authentication. Code against the Telesign status or error codes from the status.code and errors.code properties in the response payload, rather than the HTTP status code of the response.
Required 'Authorization' header is not in the correct format
-30006
Invalid Signature
-30007
Missing required 'Date' or 'x-ts-date' header
-30008
Invalid 'x-ts-auth-method' header.
-30009
'Date' or 'x-ts-date' header is not RFC822 compliant
-30010
'Date' or 'x-ts-date' header is not within tolerable range
-30011
'x-ts-nonce' header value is either too long or too short
-30012
'x-ts-nonce' header value has been used recently
-30015
Invalid API Key.
404
Not found. The server has not found anything matching the request URI. Code against the Telesign status or error codes from the status.code and errors.code properties in the response payload, rather than the HTTP status code of the response.
Error Code
Associated text string
-10001
CustomerID/ReferenceID not found
-10001
CustomerID/ReferenceID not found: CustomerID/ReferenceID Parameter: <parameter>
-10004
Reference ID expired.
Associated text string for -10001 will change depending on the parameter.
429
Too many requests. The user sent too many requests in a given amount of time. Code against the Telesign status or error codes from the status.code and errors.code properties in the response payload, rather than the HTTP status code of the response.
Error Code
Associated text string
-40007
Rate Limit Exceeded
-40008
<product> exceeded transaction hard cap. Request denied.
503
Service unavailable. The system is unavailable, try again. Code against the Telesign status or error codes from the status.code and errors.code properties in the response payload, rather than the HTTP status code of the response.
Error Code
Associated text string
-90001
System Unavailable, please try again later.
Updated 14 days ago
Language
ShellNodeRubyPHPPython
Credentials
Basic
base64
Basic
:
cURL Request
Response
Click Try It! to start a request and see the response here! Or choose an example: