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.8065 RON
ALAlbania 0.5785 RON
DZAlgeria 1.4713 RON
ASAmerican Samoa 0.6174 RON
ADAndorra 0.4377 RON
AOAngola 0.4099 RON
AIAnguilla 0.8512 RON
AGAntigua & Barbuda 1.1665 RON
ARArgentina 0.4761 RON
AMArmenia 1.1166 RON
AWAruba 0.6936 RON
AUAustralia 0.1592 RON
ATAustria 0.2732 RON
AZAzerbaijan 1.6331 RON
BSBahamas 0.3841 RON
BHBahrain 0.2207 RON
BDBangladesh 2.4140 RON
BBBarbados 1.2811 RON
BYBelarus 0.9264 RON
BEBelgium 0.4256 RON
BZBelize 1.0935 RON
BJBenin 1.1660 RON
BMBermuda 1.2811 RON
BTBhutan 1.6421 RON
BOBolivia 1.0877 RON
BABosnia & Herzegovina 0.7409 RON
BWBotswana 0.6899 RON
BRBrazil 0.1319 RON
IOBritish Indian Ocean Territory 0.5990 RON
VGBritish Virgin Islands 1.2811 RON
BNBrunei 0.2958 RON
BGBulgaria 0.7225 RON
BFBurkina Faso 0.9616 RON
BIBurundi 2.0808 RON
KHCambodia 1.5764 RON
CMCameroon 1.2926 RON
CACanada 0.1103 RON
CVCape Verde 1.0015 RON
KYCayman Islands 1.1823 RON
CFCentral African Republic 0.4572 RON
TDChad 1.5270 RON
CLChile 0.2149 RON
CNChina 0.1251 RON
COColombia 0.0988 RON
KMComoros 1.6710 RON
CGCongo - Brazzaville 1.0246 RON
CDCongo - Kinshasa 1.4503 RON
CKCook Islands 0.5953 RON
CRCosta Rica 0.1445 RON
HRCroatia 0.6805 RON
CUCuba 0.4304 RON
ANCuraçao 0.6306 RON
CWCuraçao 1.4450 RON
CYCyprus 0.5092 RON
CZCzechia 0.2601 RON
CICôte d’Ivoire 1.3399 RON
DKDenmark 0.2422 RON
DJDjibouti 0.6148 RON
DMDominica 0.9931 RON
DODominican Republic 0.6337 RON
ECEcuador 1.3715 RON
EGEgypt 1.4660 RON
SVEl Salvador 0.5990 RON
GQEquatorial Guinea 0.9458 RON
EREritrea 0.4882 RON
EEEstonia 0.2464 RON
SZEswatini 0.8040 RON
ETEthiopia 1.4450 RON
FKFalkland Islands 0.3437 RON
FOFaroe Islands 0.2512 RON
FJFiji 0.8870 RON
FIFinland 0.2207 RON
FRFrance 0.2596 RON
GFFrench Guiana 0.2816 RON
PFFrench Polynesia 0.4230 RON
GAGabon 1.4124 RON
GMGambia 0.8213 RON
GEGeorgia 0.6337 RON
DEGermany 0.4577 RON
GHGhana 1.1508 RON
GIGibraltar 0.3352 RON
GRGreece 0.2291 RON
GLGreenland 0.0594 RON
GDGrenada 1.1823 RON
GPGuadeloupe 0.5833 RON
GUGuam 0.6463 RON
GTGuatemala 1.0246 RON
GNGuinea 1.2611 RON
GWGuinea-Bissau 1.1665 RON
GYGuyana 1.2611 RON
HTHaiti 1.2811 RON
HNHonduras 0.6936 RON
HKHong Kong SAR China 0.2948 RON
HUHungary 0.3415 RON
ISIceland 0.3316 RON
INIndia 0.3915 RON
IDIndonesia 2.1176 RON
IRIran 1.7971 RON
IQIraq 1.7671 RON
IEIreland 0.2207 RON
ILIsrael 1.0509 RON
ITItaly 0.2512 RON
JMJamaica 0.6274 RON
JPJapan 0.2654 RON
JOJordan 1.6394 RON
KZKazakhstan 1.7734 RON
KEKenya 0.6306 RON
KIKiribati 0.2675 RON
XKKosovo 1.3137 RON
KWKuwait 1.5107 RON
KGKyrgyzstan 1.3499 RON
LALaos 0.6621 RON
LVLatvia 0.2627 RON
LBLebanon 0.2522 RON
LSLesotho 1.2453 RON
LRLiberia 0.9458 RON
LYLibya 1.6752 RON
LILiechtenstein 0.2097 RON
LTLithuania 0.2133 RON
LULuxembourg 0.5360 RON
MOMacao SAR China 0.2312 RON
MGMadagascar 2.0524 RON
MWMalawi 1.3793 RON
MYMalaysia 0.7882 RON
MVMaldives 0.3310 RON
MLMali 1.1192 RON
MTMalta 0.2880 RON
MHMarshall Islands 0.2958 RON
MQMartinique 0.2627 RON
MRMauritania 1.1980 RON
MUMauritius 0.8118 RON
MXMexico 0.3783 RON
FMMicronesia 0.3878 RON
MDMoldova 0.7004 RON
MCMonaco 0.6905 RON
MNMongolia 1.5438 RON
MEMontenegro 0.7556 RON
MSMontserrat 0.6621 RON
MAMorocco 0.3783 RON
MZMozambique 0.6621 RON
MMMyanmar (Burma) 1.9379 RON
NANamibia 0.2228 RON
NRNauru 0.8870 RON
NPNepal 1.2926 RON
NLNetherlands 0.4009 RON
NCNew Caledonia 0.6232 RON
NZNew Zealand 0.2207 RON
NINicaragua 0.6148 RON
NENiger 1.4781 RON
NGNigeria 1.7655 RON
NUNiue 0.8539 RON
KPNorth Korea 0.4409 RON
MKNorth Macedonia 0.4629 RON
NONorway 0.1892 RON
OMOman 0.9196 RON
PKPakistan 1.8917 RON
PWPalau 0.6017 RON
PSPalestinian Territories 1.5533 RON
PAPanama 0.7724 RON
PGPapua New Guinea 1.0183 RON
PYParaguay 0.4414 RON
PEPeru 0.6621 RON
PHPhilippines 1.1134 RON
PLPoland 0.1314 RON
PTPortugal 0.1382 RON
PRPuerto Rico 0.5491 RON
QAQatar 0.5517 RON
RORomania 0.2433 RON
RURussia 2.1218 RON
RWRwanda 1.4613 RON
RERéunion 0.3310 RON
WSSamoa 0.7409 RON
SMSan Marino 0.2943 RON
SASaudi Arabia 1.0089 RON
SNSenegal 1.2453 RON
RSSerbia 1.0246 RON
SCSeychelles 0.5675 RON
SLSierra Leone 1.2296 RON
SGSingapore 0.2422 RON
SXSint Maarten 0.4918 RON
SKSlovakia 0.2669 RON
SISlovenia 0.8213 RON
SBSolomon Islands 0.4414 RON
SOSomalia 1.1192 RON
ZASouth Africa 0.2522 RON
KRSouth Korea 0.1051 RON
SSSouth Sudan 1.3793 RON
ESSpain 0.1944 RON
LKSri Lanka 1.9673 RON
SHSt. Helena 0.4929 RON
KNSt. Kitts & Nevis 1.2811 RON
LCSt. Lucia 1.2453 RON
PMSt. Pierre & Miquelon 0.6306 RON
VCSt. Vincent & Grenadines 0.9931 RON
SDSudan 1.6095 RON
SRSuriname 1.1508 RON
SESweden 0.2548 RON
CHSwitzerland 0.3121 RON
SYSyria 1.5470 RON
STSão Tomé & Príncipe 0.1261 RON
TWTaiwan 0.3941 RON
TJTajikistan 1.8959 RON
TZTanzania 1.4124 RON
THThailand 0.0920 RON
TLTimor-Leste 0.7724 RON
TGTogo 0.9143 RON
TKTokelau 0.1314 RON
TOTonga 0.8870 RON
TTTrinidad & Tobago 1.2453 RON
TNTunisia 1.5133 RON
TMTurkmenistan 1.1497 RON
TCTurks & Caicos Islands 0.8376 RON
TVTuvalu 0.8213 RON
TRTürkiye 0.0399 RON
VIU.S. Virgin Islands 0.1939 RON
UGUganda 1.4844 RON
UAUkraine 0.9196 RON
AEUnited Arab Emirates 0.4797 RON
GBUnited Kingdom 0.2107 RON
USUnited States 0.1103 RON
ZZUnknown Region 0.4335 RON
UYUruguay 0.5586 RON
UZUzbekistan 2.0362 RON
VUVanuatu 0.8670 RON
VEVenezuela 0.6936 RON
VNVietnam 1.1660 RON
WFWallis & Futuna 0.3894 RON
YEYemen 0.9064 RON
ZMZambia 1.3762 RON
ZWZimbabwe 0.9558 RON