Send SMS verification code

post

https://rest-ww.telesign.com/v1/verify/sms

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

`status.code` and `errors.code` properties in the response payload, rather than the HTTP status code of the response.

Status code Associated text string Description
290 Message in progress The message is being sent to the SMS gateway.

Status code	Associated text string	Description
290	Message in progress	The message is being sent to the SMS gateway.

Status code	Status description	Error code	Description
500	Transaction not attempted	-10001	Invalid Request: {parameter name} Parameter: {parameter value}
500	Transaction not attempted	-10001	Invalid Request: Missing Parameter: {parameter name}
500	Transaction not attempted	-10001	Invalid Request: {parameter name} Parameter
500	Transaction not attempted	-10001	Not Allowed Host: IP/Hostname Parameter: {host_ip_address}/{host_name}
500	Transaction not attempted	-40006	Bad request

Status code	Status description	Error code	Description
500	Transaction not attempted	-10009	Invalid source IP address
500	Transaction not attempted	-10033	{phone_number} has not been verified for this trial account.
501	Not authorized	-20002	This product is not enabled for this Customer ID.
501	Not authorized	-30000	Invalid Customer ID.
501	Not authorized	-30001	Customer ID Account Suspended.
501	Not authorized	-30004	Missing required 'Authorization' header
501	Not authorized	-30005	Required 'Authorization' header is not in the correct format
501	Not authorized	-30006	Invalid Signature
501	Not authorized	-30007	Missing required 'Date' or 'x-ts-date' header
500	Transaction not attempted	-30008	Invalid 'x-ts-auth-method' header.
501	Not authorized	-30009	'Date' or 'x-ts-date' header is not RFC822 compliant
501	Not authorized	-30010	'Date' or 'x-ts-date' header is not within tolerable range
501	Not authorized	-30011	'x-ts-nonce' header value is either too long or too short
501	Not authorized	-30012	'x-ts-nonce' header value has been used recently
501	Not authorized	-30015	Invalid API Key.

Status code	Status description	Error code	Description
500	Transaction not attempted	-40007	Rate Limit Exceeded
500	Transaction not attempted	-40008	Verify SMS exceeded transaction hard cap. Request denied.

Status code	Status description	Error code	Description
500	Transaction not attempted	-90001	System Unavailable, please try again later.

Language

Credentials

Basic

base64

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json