Skip to content

SMS Developer API

Transactional messaging, built into your application.

Send alerts, verification messages and customer updates through a documented API designed for real operational workflows.

Built for developers

One clear API for the messages your product needs to send.

Start with a direct integration, then add controls and delivery feedback as the workflow becomes more important.

01

Send with confidence

Submit outbound SMS through a documented API with recipient and message validation before it enters the delivery queue.

02

Estimate before sending

Check the message and destination before committing usage, so your application can make deliberate decisions.

03

Follow asynchronous status

Use callbacks for delivery events and, where needed, HLR lookup results in the systems that need them.

04

Control access

Use API tokens and optional IP restrictions to keep a production integration scoped to the right system.

From request to result

A small API surface with a clear operational lifecycle.

Your application remains in control: validate the destination, estimate usage, submit once and consume delivery events asynchronously.

01 / Authorise

One token per integration.

Keep production systems isolated with revocable credentials and optional source-IP restrictions.

  • Server-side API tokens
  • Optional IP allowlists
  • No credentials in browser code
02 / Estimate

Know the message before sending.

Use the estimate operation to validate recipient and message characteristics before committing the request.

  • Destination validation
  • Message-part awareness
  • Explicit application decision
03 / Queue

Submit without blocking your product.

Accepted messages enter an asynchronous delivery workflow and return a reference your application can retain.

  • Queued processing
  • Stable message reference
  • Transactional workloads
04 / Observe

Bring status back to your system.

Delivery callbacks let your application update its own workflow without repeatedly polling for every message.

  • Webhook callbacks
  • Delivery-state events
  • Audit-friendly processing
05 / Verify

Support identity workflows.

Use SMS for account creation, requested notifications and two-step login challenges with your own expiry and retry policy.

  • Verification codes
  • Operational notifications
  • No unsolicited marketing
06 / Scale

Pay for actual messaging.

The service is usage-based. Destination, route and sender requirements are confirmed before production traffic is enabled.

  • Country-aware routing
  • Sender review where required
  • Transparent usage records

Manage credentials, allowed sources, usage and delivery activity securely from your Silurian workspace.

Good to know. Delivery confirmation and sender behaviour depend on destination country, network and approved sending route. We will help define the appropriate setup before production use.

Developer experience

Integrate SMS into your applications easily.

Send the same authenticated JSON request from your preferred server-side stack. Keep the API token outside browser code and use the estimate operation before sending when price or message length matters.

Open the interactive API reference
curl --request POST 'https://api.silurian.net/sms/v2/send' \
  --user 'YOUR_API_TOKEN:' \
  --header 'Content-Type: application/json' \
  --data '{
    "sender": "YOURBRAND",
    "message": "Your verification code is 123456.",
    "recipients": [{"msisdn": "+34XXXXXXXXX"}]
  }'
Examples use HTTP Basic authentication with the API token as username. The interactive reference also documents header, query-token and short-lived Bearer authentication.

Destination pricing

Know the destination price before your application sends.

Prices below are the current public Silurian rate per SMS part, before VAT. The API estimate operation remains authoritative because message length, destination, route and sender requirements are checked for each request.

DestinationPrice per SMS part
AFAfghanistan 1.5050 PLN
ALAlbania 0.4820 PLN
DZAlgeria 1.2257 PLN
ASAmerican Samoa 0.5144 PLN
ADAndorra 0.3646 PLN
AOAngola 0.3414 PLN
AIAnguilla 0.7092 PLN
AGAntigua & Barbuda 0.9718 PLN
ARArgentina 0.3966 PLN
AMArmenia 0.9302 PLN
AWAruba 0.5778 PLN
AUAustralia 0.1326 PLN
ATAustria 0.2276 PLN
AZAzerbaijan 1.3605 PLN
BSBahamas 0.3200 PLN
BHBahrain 0.1839 PLN
BDBangladesh 2.0110 PLN
BBBarbados 1.0672 PLN
BYBelarus 0.7718 PLN
BEBelgium 0.3546 PLN
BZBelize 0.9110 PLN
BJBenin 0.9714 PLN
BMBermuda 1.0672 PLN
BTBhutan 1.3680 PLN
BOBolivia 0.9061 PLN
BABosnia & Herzegovina 0.6172 PLN
BWBotswana 0.5748 PLN
BRBrazil 0.1099 PLN
IOBritish Indian Ocean Territory 0.4990 PLN
VGBritish Virgin Islands 1.0672 PLN
BNBrunei 0.2465 PLN
BGBulgaria 0.6019 PLN
BFBurkina Faso 0.8011 PLN
BIBurundi 1.7335 PLN
KHCambodia 1.3133 PLN
CMCameroon 1.0769 PLN
CACanada 0.0919 PLN
CVCape Verde 0.8344 PLN
KYCayman Islands 0.9849 PLN
CFCentral African Republic 0.3808 PLN
TDChad 1.2721 PLN
CLChile 0.1790 PLN
CNChina 0.1042 PLN
COColombia 0.0823 PLN
KMComoros 1.3920 PLN
CGCongo - Brazzaville 0.8536 PLN
CDCongo - Kinshasa 1.2082 PLN
CKCook Islands 0.4960 PLN
CRCosta Rica 0.1204 PLN
HRCroatia 0.5669 PLN
CUCuba 0.3585 PLN
ANCuraçao 0.5253 PLN
CWCuraçao 1.2038 PLN
CYCyprus 0.4242 PLN
CZCzechia 0.2167 PLN
CICôte d’Ivoire 1.1163 PLN
DKDenmark 0.2018 PLN
DJDjibouti 0.5122 PLN
DMDominica 0.8273 PLN
DODominican Republic 0.5279 PLN
ECEcuador 1.1425 PLN
EGEgypt 1.2213 PLN
SVEl Salvador 0.4990 PLN
GQEquatorial Guinea 0.7880 PLN
EREritrea 0.4067 PLN
EEEstonia 0.2053 PLN
SZEswatini 0.6698 PLN
ETEthiopia 1.2038 PLN
FKFalkland Islands 0.2863 PLN
FOFaroe Islands 0.2092 PLN
FJFiji 0.7389 PLN
FIFinland 0.1839 PLN
FRFrance 0.2162 PLN
GFFrench Guiana 0.2346 PLN
PFFrench Polynesia 0.3524 PLN
GAGabon 1.1767 PLN
GMGambia 0.6842 PLN
GEGeorgia 0.5279 PLN
DEGermany 0.3813 PLN
GHGhana 0.9587 PLN
GIGibraltar 0.2793 PLN
GRGreece 0.1909 PLN
GLGreenland 0.0495 PLN
GDGrenada 0.9849 PLN
GPGuadeloupe 0.4859 PLN
GUGuam 0.5384 PLN
GTGuatemala 0.8536 PLN
GNGuinea 1.0506 PLN
GWGuinea-Bissau 0.9718 PLN
GYGuyana 1.0506 PLN
HTHaiti 1.0672 PLN
HNHonduras 0.5778 PLN
HKHong Kong SAR China 0.2456 PLN
HUHungary 0.2845 PLN
ISIceland 0.2762 PLN
INIndia 0.3261 PLN
IDIndonesia 1.7641 PLN
IRIran 1.4971 PLN
IQIraq 1.4722 PLN
IEIreland 0.1839 PLN
ILIsrael 0.8755 PLN
ITItaly 0.2092 PLN
JMJamaica 0.5227 PLN
JPJapan 0.2211 PLN
JOJordan 1.3658 PLN
KZKazakhstan 1.4774 PLN
KEKenya 0.5253 PLN
KIKiribati 0.2228 PLN
XKKosovo 1.0944 PLN
KWKuwait 1.2585 PLN
KGKyrgyzstan 1.1246 PLN
LALaos 0.5516 PLN
LVLatvia 0.2189 PLN
LBLebanon 0.2101 PLN
LSLesotho 1.0375 PLN
LRLiberia 0.7880 PLN
LYLibya 1.3955 PLN
LILiechtenstein 0.1747 PLN
LTLithuania 0.1777 PLN
LULuxembourg 0.4465 PLN
MOMacao SAR China 0.1926 PLN
MGMadagascar 1.7099 PLN
MWMalawi 1.1491 PLN
MYMalaysia 0.6566 PLN
MVMaldives 0.2758 PLN
MLMali 0.9324 PLN
MTMalta 0.2399 PLN
MHMarshall Islands 0.2465 PLN
MQMartinique 0.2189 PLN
MRMauritania 0.9981 PLN
MUMauritius 0.6763 PLN
MXMexico 0.3152 PLN
FMMicronesia 0.3231 PLN
MDMoldova 0.5835 PLN
MCMonaco 0.5752 PLN
MNMongolia 1.2861 PLN
MEMontenegro 0.6295 PLN
MSMontserrat 0.5516 PLN
MAMorocco 0.3152 PLN
MZMozambique 0.5516 PLN
MMMyanmar (Burma) 1.6144 PLN
NANamibia 0.1856 PLN
NRNauru 0.7389 PLN
NPNepal 1.0769 PLN
NLNetherlands 0.3340 PLN
NCNew Caledonia 0.5192 PLN
NZNew Zealand 0.1839 PLN
NINicaragua 0.5122 PLN
NENiger 1.2314 PLN
NGNigeria 1.4708 PLN
NUNiue 0.7113 PLN
KPNorth Korea 0.3673 PLN
MKNorth Macedonia 0.3857 PLN
NONorway 0.1576 PLN
OMOman 0.7661 PLN
PKPakistan 1.5759 PLN
PWPalau 0.5012 PLN
PSPalestinian Territories 1.2940 PLN
PAPanama 0.6435 PLN
PGPapua New Guinea 0.8484 PLN
PYParaguay 0.3677 PLN
PEPeru 0.5516 PLN
PHPhilippines 0.9276 PLN
PLPoland 0.1094 PLN
PTPortugal 0.1151 PLN
PRPuerto Rico 0.4574 PLN
QAQatar 0.4596 PLN
RORomania 0.2027 PLN
RURussia 1.7676 PLN
RWRwanda 1.2174 PLN
RERéunion 0.2758 PLN
WSSamoa 0.6172 PLN
SMSan Marino 0.2451 PLN
SASaudi Arabia 0.8405 PLN
SNSenegal 1.0375 PLN
RSSerbia 0.8536 PLN
SCSeychelles 0.4728 PLN
SLSierra Leone 1.0243 PLN
SGSingapore 0.2018 PLN
SXSint Maarten 0.4097 PLN
SKSlovakia 0.2224 PLN
SISlovenia 0.6842 PLN
SBSolomon Islands 0.3677 PLN
SOSomalia 0.9324 PLN
ZASouth Africa 0.2101 PLN
KRSouth Korea 0.0876 PLN
SSSouth Sudan 1.1491 PLN
ESSpain 0.1620 PLN
LKSri Lanka 1.6389 PLN
SHSt. Helena 0.4106 PLN
KNSt. Kitts & Nevis 1.0672 PLN
LCSt. Lucia 1.0375 PLN
PMSt. Pierre & Miquelon 0.5253 PLN
VCSt. Vincent & Grenadines 0.8273 PLN
SDSudan 1.3408 PLN
SRSuriname 0.9587 PLN
SESweden 0.2123 PLN
CHSwitzerland 0.2600 PLN
SYSyria 1.2887 PLN
STSão Tomé & Príncipe 0.1051 PLN
TWTaiwan 0.3283 PLN
TJTajikistan 1.5794 PLN
TZTanzania 1.1767 PLN
THThailand 0.0766 PLN
TLTimor-Leste 0.6435 PLN
TGTogo 0.7617 PLN
TKTokelau 0.1094 PLN
TOTonga 0.7389 PLN
TTTrinidad & Tobago 1.0375 PLN
TNTunisia 1.2607 PLN
TMTurkmenistan 0.9578 PLN
TCTurks & Caicos Islands 0.6978 PLN
TVTuvalu 0.6842 PLN
TRTürkiye 0.0333 PLN
VIU.S. Virgin Islands 0.1615 PLN
UGUganda 1.2366 PLN
UAUkraine 0.7661 PLN
AEUnited Arab Emirates 0.3997 PLN
GBUnited Kingdom 0.1755 PLN
USUnited States 0.0919 PLN
ZZUnknown Region 0.3611 PLN
UYUruguay 0.4653 PLN
UZUzbekistan 1.6963 PLN
VUVanuatu 0.7223 PLN
VEVenezuela 0.5778 PLN
VNVietnam 0.9714 PLN
WFWallis & Futuna 0.3244 PLN
YEYemen 0.7551 PLN
ZMZambia 1.1465 PLN
ZWZimbabwe 0.7963 PLN