Activation API

Ordering a phone number

This request is intended to receive a virtual number. It allows you to set parameters such as service, carrier, and country to get a number for later use.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY

Input parameters

Parameter	The values that this parameter accepts	Obligatory	Description
APIKEY	See in the account settings	Yes	The API key provides access to paid services.
SERVICE	See the list of services in the left menu	Yes	The service for which you need to receive a number
OPERATOR	See the list of operators in the left menu.	No	The mobile operator whose number you need to get
COUNTRY	See the list of countries in the left menu.	Yes	The country whose number you need to get
URL	Full webhook URL (http/https)	No	Webhook endpoint. If set, we POST SMS data to this URL when an SMS arrives for the purchased number.
MAXPRICE	Number (integer or decimal with a dot)	No	If the number being purchased costs more than the passed parameter, NO_NUMBERS will be returned even if numbers are available.

The service's response

The service's response	Example	Description
ACCESS_NUMBER:ID:NUMBER	ACCESS_NUMBER:234242:79123456789	We received a number, an activation ID, and the number itself with the country code is a NUMBER

Change the status

This request is used to manage the status of the number in the system.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID

Input parameters

Parameter	The values that this parameter accepts	Obligatory	Description
APIKEY	See in the account settings	Yes	The API key provides access to paid services.
ID	Numeric value	Yes	Activation ID received when requesting a number
STATUS	Numeric value	Yes	The status that needs to be transferred to the number

Supported status values:

3 - SMS resend requested

6 - activation successfully completed

8 - activation cancelled, refund issued

The service's response

The service's response	Description
STATUS_WAIT_CODE	Waiting for an SMS message to be received
ACCESS_ACTIVATION	Activation completed successfully
ACCESS_CANCEL	Activation cancelled

Get a status

This request is used to get the status of the number in the system.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID

Input parameters

Parameter	The values that this parameter accepts	Obligatory	Description
APIKEY	See in the account settings	Yes	The API key provides access to paid services.
ID	Numeric value	Yes	Activation ID received when requesting a number

The service's response

The service's response	Description
STATUS_WAIT_CODE	Waiting for an SMS message to be received
STATUS_CANCEL	Activation cancelled
STATUS_OK:CODE	The received code (CODE is the activation code

Request the number of available numbers

The request is intended to get information about the available number of phone numbers.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR

Input parameters

Parameter	The values that this parameter accepts	Obligatory	Description
APIKEY	See in the account settings	Yes	The API key provides access to paid services.
COUNTRY	See the list of services in the left menu	Yes	The country of the number
OPERATOR	See the list of operators in the left menu	No	The number operator. If no parameter is specified, a random operator will be used.

The service's response

The service's response	Description
JSON response	Response in the format {"Service_0":"Quantity"}

Request all prices

This request allows you to get a list of available prices for this service and the country. It is used to get up-to-date information about the cost of services.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY

Input parameters

Parameter	The values that this parameter accepts	Obligatory	Description
APIKEY	See in the account settings	Yes	The API key provides access to paid services.
COUNTRY	See the list of countries in the left menu	Yes	The country of the number
SERVICE	See the list of services in the left menu	No	Necessary service

The service's response

The service's response	Description
JSON response	Response in the format {"Country":{"Price":Quanity}}}

Balance request

This request is used to get the current account balance associated with the specified API key.

https://api.smsfast.com/stubs/handler_api.php?api_key=APIKEY&action=getBalance

Input parameters

Parameter	The values that this parameter accepts	Obligatory	Description
APIKEY	See in the account settings	Yes	The API key provides access to paid services.

The service's response

The service's response	Example	Description
ACCESS_BALANCE:BALANCE	ACCESS_BALANCE:540	BALANCE - your account balance

General information