The SMS API from Orange allows you to send and receive text messages within your web application to almost
all the countries and operators in the world.
Use this API to create your very own SMS application on the web.
*** update update update ***
update: the coverage zone’s extension is not limited to the sendSMS method anymore
That’s right, you can now receive SMS (receiveSMS method) from the whole world using this number we provide : +447797805210 (reception cost : 5 credits).
On the other hand, please make sure that you clearly indicate to your end users to start the phone number by the “+” sign, or else the SMS won’t be sent..
sendSMS coverage zone is extended
Since the launch of the SMS API, we’ve been expanding the coverage zone.
The SMS API has been recently updated and you are no longer limited to European countries, and can now reach the whole world (almost)*.
For a list of all the countries and operators available with the SMS API (using the sendSMS method), download the Orange SMS API coverage PDF
* Orange delivers the SMS on a wide international coverage on best effort basis, and we'll make sure the SMS is delivered to the third party operators .
However, the final delivery leg of the SMS to the recipient's mobile is within the third operator's control.
In a nutshell, the SMS API enables you to:
send text messages
receive text messages through your e-mail and URL
- these settings can be configured via our simple API manager
earn credits through the use of premium short codes***
*** premium short codes are currently only available for users on a French network.
The SMS API is a web-service to send and receive text message (limited to 160 characters).
The web service exposes a REST-RPC style interface.
The requests use GET and POST methods in HTTP or HTTPS mode.
Currently, the API is in beta mode
This means that it is based around a commercial model allowing you to purchase credits for sending and receiving text messages.
There are no daily limits for either sending or receiving text messages as you are now able to purchase credit bundles in Euros for sending and receiving messages.
And you can also earn credits by receiving text messages to your application via one of our French premium short codes.
It will cost you credits each time you use the SMS API to send or receive text messages. The cost is deducted from your pre-pay account. There are special offers when you top-up by a certain amount, see below:
Remember, you can earn credits if your application users send you a text message using one our premium short codes (currently we only provide French premium short codes).
The credits (revenue) generated is added to your pre-pay account.
You can check how much credit you have left, top-up your account (using Visa or Mastercard) and view how much you've earned in the API manager
The current credit cost for the SMS API calls are :
| method |
destination number used |
API call cost |
amount added or subtracted |
| sendSMS |
France
(Orange mobiles only)
From 20345
France
(any mobile - Orange, SFR, Bouygues)
From 38100
UK
(Orange mobiles only)
From 967482 |
10 credits |
subtracted from pre-pay account |
International
From 447797805210
view the coverage zone
|
15 credits |
subtracted from pre-pay account |
| receiveSMS |
France
(Orange mobiles only)
To 20345
France
(any mobile - Orange, SFR, Bouygues)
To 31244
UK
(Orange mobiles only)
To 967482
International
(any country, any operator)
To +447797805210 |
5 credits |
subtracted from pre-pay account |
France - surcharged
(any mobile - Orange, SFR, Bouygues)
To 51244 (Premium number) |
6 credits reward |
added to your pre-pay account |
France - surcharged
(any mobile - Orange, SFR, Bouygues)
To 71244 (Premium number) |
18 credits reward |
added to your pre-pay account |
Here are the prices to send an SMS to France or the UK from 20345, 38100, or 967482 :
top-up amount
(all taxes included) |
top-up amount
(French VAT excluded) |
number of credits
(added to your account) |
price per SMS MT to France
in € without VAT |
| 10 € |
8,36 € |
1000 |
0,084 € |
| 50 € |
41, 82 € |
5350 |
0,078 € |
| 100 € |
83,61 € |
11000 |
0,076 € |
| 500 € |
418,06 € |
56000 |
0,075 € |
| 1000 € |
836,12 € |
113000 |
0,074 € |
some notes on earning credits from the SMS API
Please remember that you can only generate revenue by receiving text messages via one of the French premium short codes (51244 or 71244). Your application must respond with a text message to the end user – this text message is free and is not done using the sendSMS method. Refer to the documentation section for more information.
The cost of sending your application a text message - to your application users - via the different numbers are detailed below :
| short code |
where can it be used? |
how is it charged to end users? |
| 20345 |
France
(Orange mobiles only) |
charged at normal SMS rate |
| 31244 |
France
(any mobile - Orange, SFR, Bouygues) |
charged at normal SMS rate |
51244
(premium) |
France
(any mobile - Orange, SFR, Bouygues) |
charged at normal SMS rate + 0.20€ |
71244
(premium) |
France
(any mobile - Orange, SFR, Bouygues) |
charged at normal SMS rate + 0.50€ |
| 967482 |
UK
(Orange mobiles only) |
charged at normal SMS rate |
| +447797805210 |
International
(any country, any operator) |
charged by the local operator |
access the terms & conditions of use
(back to top)
