API is a connection protocol between your software and our activation service. It is needed to automate the process of receiving SMS on your side.
All requests (only GET) must go to this address:
https://365sms.org/stubs/handler_api.php
For compatibility with software that does not have our service, add a line 46.36.219.142 domain in file C:\Windows\System32\drivers\etc\hosts
Replace domain with the domain used in the software.
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR
| Option | Accepted values | Obligation | Description |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Yes | API-key provides access to paid services |
| COUNTRY | List of countries in the left menu | Yes | Country number |
| OPERATOR | List of operators in the left menu | No | Number operator. If the parameter is not specified, a random operator will be used |
The server response will be in json format, an example:
{"vk_0":890,"ok_0":192,"wa_0":146,"vi_0":199,"tg_0":101,"wb_0":103,"go_0":467,"av_0":177,"fb_0":132,"tw_0":479}
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getBalance
| Option | Accepted values | Obligation | Description |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Yes | API-key provides access to paid services |
| Server response | Example | Description |
|---|---|---|
| ACCESS_BALANCE:BALANCE | ACCESS_BALANCE:540 | BALANCE - your account balance |
| Server response | Description |
|---|---|
| BAD_KEY | Invalid API key |
| ERROR_SQL | SQL server error |
| BAD_ACTION | The request is not formed correctly |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY
| Option | Accepted values | Obligation | Description |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Yes | API-key provides access to paid services |
| SERVICE | List of services in the left menu | Yes | Service for which you need to get number |
| OPERATOR | Accepted parameters depend on the specific country. For clarification, see the list of operators on the left menu | No | Cellular operator whose number you need to get |
| COUNTRY | List of countries in the left menu | Yes | Country number to get |
| Server Responses | Example | Description |
|---|---|---|
| NO_NUMBERS | NO_NUMBERS | There are no numbers with the specified parameters, try again later, or change the operator, country. |
| NO_BALANCE | NO_BALANCE | Account balance ran out of money |
| WRONG_SERVICE | WRONG_SERVICE | Invalid service identifier |
| ACCESS_NUMBER:ID:NUMBER | ACCESS_NUMBER:234242:79123456789 | Received a number, activation ID - ID, number itself with country code - NUMBER |
| Server Responses | Description |
|---|---|
| BAD_ACTION | The request is not formed correctly |
| BAD_SERVICE | Incorrect service name |
| BAD_KEY | Invalid API key |
| ERROR_SQL | SQL server error |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID
| Option | Accepted values | Obligation | Description |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Yes | API-key provides access to paid services |
| ID | Numerical value | Yes | Activation ID received when requesting the number |
| STATUS | 3 - SMS needs to be repeated, 6 - activation successfully completed, 8 - cancel activation |
Yes | The status to be transferred to activation |
What status when to send?
Immediately after receiving the number, the number is waiting for SMS.
The following actions are available to you:
8 - Cancel activation
Immediately after receiving the code:
3 - Request another SMS
6 - Confirm the SMS code and complete the activation
For activation with status 3:
6 - Confirm the SMS code and complete the activation
| Server response | Description |
|---|---|
| STATUS_WAIT_CODE | We are waiting for the arrival of SMS |
| ACCESS_ACTIVATION | Activation successfully completed |
| ACCESS_CANCEL | Activation canceled |
| Server response | Description |
|---|---|
| BAD_ACTION | The request is not formed correctly |
| BAD_SERVICE | Incorrect service name |
| BAD_KEY | Invalid API key |
| NO_ACTIVATION | Activation ID does not exist |
| ERROR_SQL | SQL server error |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID
| Option | Accepted values | Obligation | Description |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Yes | API-key provides access to paid services |
| ID | Numerical value | Yes | Activation ID received when requesting the number |
| Server response | Description |
|---|---|
| STATUS_WAIT_CODE | We are waiting for the arrival of SMS |
| STATUS_CANCEL | Activation canceled |
| STATUS_OK:CODE | Code received (where CODE - activation code) |
| Server response | Description |
|---|---|
| BAD_ACTION | The request is not formed correctly |
| BAD_KEY | Invalid API key |
| NO_ACTIVATION | Activation id does not exist |
| ERROR_SQL | SQL server error |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY
| Option | Accepted values | Obligation | Description |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Yes | API-key provides access to paid services |
| SERVICE | List of services in the left menu | No | Service for which you need to get number |
| COUNTRY | List of countries in the left menu | Yes | Country number |
| Server response | Description |
|---|---|
| JSON response | Answer in format { "Country": { "Service": { "Cost": Quantity}}} |