API

API KEY

YOUR_API_KEY

API URL

https://activate-api.smsverified.com/stubs/handler_api.php

getBalance

Get balance

Description

Get user balance

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	getBalance

Response type

text/html

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getBalance

Example response

ACCESS_BALANCE:44.60

getCountries

Get available countries

Description

Get countries with available numbers

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	getCountries

Response type

application/json

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getCountries

Example response

{
  "31": {
    "id": 48,
    "rus": "Нидерланды",
    "eng": "Netherlands",
    "chn": "荷兰",
    "visible": 1,
    "rent": 0
  },
  "33": {
    "id": 78,
    "rus": "Франция",
    "eng": "France",
    "chn": "法國",
    "visible": 1,
    "rent": 0
  }
}

getNumbersStatus

Get available numbers information

Description

Get information about available numbers for services

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	getNumbersStatus
country	Number	ID of the country

Response type

application/json

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getNumbersStatus&country=78

Example response

{
  "yahoo_0": 167,
  "wolt_0": 416,
  "telegram_0": 76,
  "snapchat_0": 391,
  "yemeksepeti_0": 416,
  "amazon_0": 83
}

getNumber

Get number for activation

Description

Get number for activation. Returns response ACCESS_NUMBER:ACCESS_ID:NUMBER where ACCESS_ID is ID of the number and NUMBER is the number itself

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	getNumber
country	Number	ID of the country
service	String	name of the service
maxPrice	Number	maximum price for the number in USD (for example 1.2)
activationType	Number	activation type (0 - receive SMS (code in SMS); 1 - call (code as the calling number); 2 - voice message (the robot calls and the code is spoken by the robot voice)). Default is 0 - SMS

Response type

text/html

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getNumber&country=48&service=vk

Example response

ACCESS_NUMBER:8601705018416664:33774545375

getStatus

Get activation code

Description

This request returns a short code contained in SMS received by the specified number (to see the full text of the message, check getFullSms request). This request can be used when you're sure that no other information in message is worth to store or use in future, other than a code. Otherwise consider using getFullSms request.

Server response:
STATUS_OK:CODE - Code received (where CODE - activation code)
STATUS_WAIT_CODE - We are waiting for the arrival of SMS
STATUS_WAIT_RETRY:LASTCODE - We are waiting for another SMS LASTCODE - last received sms
STATUS_CANCEL - activation canceled
NO_ACTIVATION - activation is not found,
BAD_ACTION - invalid action

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	getStatus
id	Number	ID of activation

Response type

text/html

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getStatus&id=2791705004917001

Example response

STATUS_OK:877613

getFullSms

Get full sms

Description

This request returns a full context of received SMS of a given number. You might want to use this request when provided by getStatus information is not enough to comprehence or you need some data that is contaied in the message, for example when SMS contains not only a verification code, but also the link for promocode, date and time of receipt or any other information that you want to use in your application. If there is an SMS, the response will be in the format: 'FULL_SMS:[sender] SMS_message'

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	getFullSms
id	Number	ID of activation

Response type

text/html

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getFullSms&id=2791705004917001

Example response

FULL_SMS:[vk] 877613

setStatus

Update activation status

Description

This request allows you to change the status of the operation according to its results (cancel operation, get next SMS code, close operation). You might want to use this request when you want explicitly change the status of the operation, for example when your application needs to retrieve information from the second message received by this number.

Status code:
1 - inform when the phone number is ready (SMS was sent to this number),
3 - request digital code from the next message,
6 - close the operation
8 - Cancel the activation (if the number does not match you)

Server response:
ACCESS_READY - SMS waiting readiness
ACCESS_RETRY_GET - activation is successfully created, but the number is not ready yet,
ACCESS_ACTIVATION - Activation completed successfully
ACCESS_CANCEL - activation is canceled,
NO_ACTIVATION - activation is not found,
BAD_ACTION - invalid action

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	setStatus
id	Number	ID of activation
status	Number	Activation status

Response type

text/html

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=setStatus&id=2791705004917001&status=1

Example response

ACCESS_ACTIVATION

getPrices

Getting information about prices.

Description

Getting information about prices. Returns JSON {Country: {Service: {cost: Cost, count: Count}}}

Parameters

Name	Type	Description
api_key	String	Your API KEY
action	String	getPrices

Response type

application/json

Example request

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getPrices

Example response

{
  "england": {
    "mb": {
      "count": 4123,
      "price": 0.4
    },
    "am": {
      "count": 4017,
      "price": 0.11
    }
  },
  "france": {
    "mb": {
      "count": 2123,
      "price": 0.13
    },
    "am": {
      "count": 2014,
      "price": 0.2
    }
  }
}