For developers
API v2.0
API is a protocol of interaction between your software and our activation server. The API is needed in order to automate the process of receiving SMS messages on your side To work with the API, you must use your API key, you can get it by going to the profile page. Our software is fully compatible with competitor sites
API Protocol Description
All requests should go to https://api.sms-man.com/control/ POST or GET request. All requests must have an API key in the form of the token parameter
Balance request
https://api.sms-man.com/control/get-balance?token=$token
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |
Result
Possible errors
Get limits
https://api.sms-man.com/control/limits?token=$token&country_id=$country_id&application_id=$application_id
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |
country_id | Integer | no | Number country |
application_id | Integer | no | Number Service |
Result
Possible errors
Request a phone number
https://api.sms-man.com/control/get-number?token=$token&country_id=$country_id&application_id=$application_id
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |
country_id | Integer | no | Number country |
application_id | Integer | no | Number Service |
maxPrice | Integer | no | your desired value |
currency | String | no | RUB/USD/EUR |
ref | String | no | Pass the referral ID |
Result
Possible errors
Get sms
https://api.sms-man.com/control/get-sms?token=$token&request_id=$request_id
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |
request_id | Integer | yes | Request ID |
Result
Possible errors
Change request status
https://api.sms-man.com/control/set-status?token=$token&request_id=$request_id&status=$status
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |
request_id | Integer | yes | Request ID |
status | String | yes | ready / close / reject / used |
Result
Possible errors
Get current prices
https://api.sms-man.com/control/get-prices?token=$token&country_id=$country_id
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |
country_id | Integer | no | Number country |
Result
Possible errors
Get list of all countries
https://api.sms-man.com/control/countries?token=$token
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |
Result
Possible errors
Get list of all services
https://api.sms-man.com/control/applications?token=$token
Parameters
Field | Type | Required | Value |
---|---|---|---|
token | String | yes | Your API key |