Create an account
To start using easysms.gr you need to sign up free of charge.
Your account is ready to use right away and 5 sms will be added to test the quality of the service.
IP whitelist for API calls
Using the IP whitelist for API calls is highly recommended to protect your account and data. It is by default activated for all accounts and you need either to enter your IP(s) to the list or deactivate the protection. When activated only calls coming from the whitelisted IPs are allowed. A credentials error will be returned otherwise.
Authentication
All API calls are authenticated the API key generated for your account. Only exception is the api/mobile/check
endpoint, which is free to use without authentication (enter your mobile below to try it). You can reset the key to a new one anytime you need.
Check the SMS API demonstration as "demo" user
or enter your own username and password
This is the 3rd version of the SMS API, it is a superset of the previous versions and therefore backwards compatible with both the 2nd version and the deprecated v. 1
- All API calls can be secured (https) or not (http)
- All API call parameters can be passed via GET or POST
- Default input encoding is the web standard UTF-8
- Mobile numbers are parsed, formated and stored in MSISDN format (Mobile Station International Subscriber Directory Number)
api/mobile
The api/mobile/check
endpoint is the only one that does not require authentication with an account key
. It is free to use for all and very powerful. It can check tens of thousands of mobiles in a fraction of a second
api/mobile/check
api/key
Endpoint to get
and reset
the API key
api/key/get
api/key/reset
api/sms
Most popular endpoints to
- send single sms
- send bulk sms
- schedule sms anytime in the future
- cancel a scheduled sms
api/sms/bulk
api/sms/cancel
api/sms/send
api/viber
Endpoints to send
a Viber message and get the balance
of the account
api/viber/send
api/viber/bulk
api/viber/balance
api/me
Account management endpoints
api/me/balance
api/2fa
Endpoints to send
and check
a 2-Factor Authentication code.
It is the same authentication methods banks are using world-wide based on the principal:
a. Something you know (username, password) and
b. Something you have (mobile)
api/2fa/send
api/2fa/check
api/contact
The api/contact/*
calls allow your applications to fully manipulate the contacts of your account and those of your sub-users accounts.
api/contact/add
api/contact/delete
api/contact/get
api/contact/list
api/contact/update
api/group
The api/group/*
calls allow your applications to fully manipulate the groups of your account and the groups of your sub-users accounts
api/group/add
api/group/addContact
api/group/delete
api/group/deleteAllContacts
api/group/deleteContact
api/group/get
api/group/list
api/history
Gives access to all sms sent for each account
api/history/group/list
api/history/single/list
api/hlr
The api/hlr/*
calls perform a real time Number Lookup providing information about number portability or/and physical geographical location of mobile numbers. HLR stands for Home Location Register.
The HLR lookup can be very useful for routing optimizations and particularly useful for authentication services.
Each call to the api/hlr/lookup
costs 1/10 of an SMS
api/hlr/lookup
Accepted parameters are the API key of the account and any mobile number to query.
Each call of api/hlr/lookup
costs 1/10 of an SMS and it is subtracted from the hlrBalance
property of the account.
The hlrBalance
of each account is initially 0.
As soon as the api/hlr/lookup
is called it checkes if the hlrBalance
is at least 1 and if it is 0 it converts 1 SMS from the account balance
to 10 hlrBalance
credits.
api/purchase
Gives access to account history of purchases
api/purchase/list
api/status
Returns the statuses of your messages
api/status/get
api/status/sms
api/user
Manipulate your account and your sub-users accounts.
More endpoints coming soon:
api/user/delete
api/user/email
api/user/emailAll
api/user/get
api/user/password
api/user/sms
api/user/smsAll
api/user/update
api/user/add
api/user/list
api/user/topup
api/user/comment
api/user/comment/add
api/user/comment/delete
myschool.sch.gr
In field 1. enter your account API key
You will find it once you sign in with your account
In field 2. enter the sender of the sms
Must me up to 11 latin characters without spaces
api/user/comment/list
Returns a list of all comments for a sub-account user
Requires IP Whitelisting