Pricing API
Account prices to specific country
Pricing API endpoints
Main API endpoint:
https://api2.messente.com/prices/
Backup API endpoint:
https://api3.messente.com/prices/
Request parameters
Key | Value | Required |
---|---|---|
username | API account user name from the Messente's web page | |
password | API account security key (API key) from the Messente's web page | |
country | Two-letter country code. Example: GB | |
format | Desired response format. Currently supported: json / xml. Defaults to "json". |
Response codes
Code | Meaning |
---|---|
ERROR 101 | Access is restricted, wrong credentials. Check the username and password values. |
ERROR 102 | Parameters are wrong or missing. Check that all the required parameters are present. |
ERROR 103 | IP address is not allowed. |
ERROR 104 | Country was not found. |
ERROR 105 | This country is not supported |
ERROR 106 | Invalid format provided. Only json or xml is allowed. |
FAILED 209 | Server failure, try again after a few seconds or try the api3.messente.com backup server. |
Example request (JSON response)
https://api2.messente.com/prices?username=api_username&password=api_password&country=EE
Successful response:
{"country":"EE","name":"Estonia","prefix":"372","networks":[
{"mccmnc":"24803","name":"Tele2","price":"0.06000"},
{"mccmnc":"24802","name":"Elisa","price":"0.06000"},
{"mccmnc":"24801","name":"EMT","price":"0.06000"}]}
Example request (XML response)
https://api2.messente.com/prices?username=api_username&password=api_password&country=EE&format=xml
Successful response:
<?xml version='1.0' encoding='UTF-8' standalone="yes"?>
<pricing>
<country>EE</country>
<name>Estonia</name>
<prefix>372</prefix>
<networks>
<network>
<mccmnc>24803</mccmnc>
<name>Tele2</name>
<price>0.06000</price>
</network>
<network>
<mccmnc>24802</mccmnc>
<name>Elisa</name>
<price>0.06000</price>
</network>
<network>
<mccmnc>24801</mccmnc>
<name>EMT</name>
<price>0.06000</price>
</network>
</networks>
</pricing>
Account full pricelist
Full Pricelist API endpoints
Main API endpoint:
https://api2.messente.com/pricelist/
Backup API endpoint:
https://api3.messente.com/pricelist/
Messente has an API for downloading the full pricelist in a developer-friendly CSV format. This is suitable for users who send to multiple destinations and require to keep their pricelist up to date at all times.
The preferred frequency when to update the pricelist is around 6 hours but no more than every 2 hours.
Request parameters
Key | Value | Required |
---|---|---|
username | API account user name from the Messente's web page | |
password | API account security key (API key) from the Messente's web page |
When the request was unsuccessful, the HTTP response includes the response code.
Response codes
Code | Meaning |
---|---|
ERROR 101 | Access is restricted, wrong credentials. Check the username and password values. |
ERROR 102 | Parameters are wrong or missing. Check that all the required parameters are present. |
ERROR 103 | IP address is not allowed. |
FAILED 209 | Server failure, try again after a few seconds or try the api3.messente.com backup server. |
Example request
https://api2.messente.com/pricelist?username=api_username&password=api_password
Successful response snippet:
Country,Code,MCCMNC,Network,Price
Canada,CA,302270,EastLink,0.0062
Papua New Guinea,PG,53703,Digicel,0.0485
India,IN,40440,Airtel - Chennai,0.0448
United States,US,310284,Verizon Wireless,0.0062
....