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 3.7194 NOK
ALAlbania 1.1911 NOK
DZAlgeria 3.0292 NOK
ASAmerican Samoa 1.2712 NOK
ADAndorra 0.9012 NOK
AOAngola 0.8438 NOK
AIAnguilla 1.7526 NOK
AGAntigua & Barbuda 2.4017 NOK
ARArgentina 0.9802 NOK
AMArmenia 2.2989 NOK
AWAruba 1.4280 NOK
AUAustralia 0.3278 NOK
ATAustria 0.5626 NOK
AZAzerbaijan 3.3624 NOK
BSBahamas 0.7908 NOK
BHBahrain 0.4544 NOK
BDBangladesh 4.9700 NOK
BBBarbados 2.6376 NOK
BYBelarus 1.9073 NOK
BEBelgium 0.8763 NOK
BZBelize 2.2513 NOK
BJBenin 2.4006 NOK
BMBermuda 2.6376 NOK
BTBhutan 3.3808 NOK
BOBolivia 2.2394 NOK
BABosnia & Herzegovina 1.5254 NOK
BWBotswana 1.4205 NOK
BRBrazil 0.2715 NOK
IOBritish Indian Ocean Territory 1.2333 NOK
VGBritish Virgin Islands 2.6376 NOK
BNBrunei 0.6091 NOK
BGBulgaria 1.4875 NOK
BFBurkina Faso 1.9798 NOK
BIBurundi 4.2841 NOK
KHCambodia 3.2456 NOK
CMCameroon 2.6614 NOK
CACanada 0.2272 NOK
CVCape Verde 2.0620 NOK
KYCayman Islands 2.4342 NOK
CFCentral African Republic 0.9412 NOK
TDChad 3.1439 NOK
CLChile 0.4425 NOK
CNChina 0.2575 NOK
COColombia 0.2034 NOK
KMComoros 3.4403 NOK
CGCongo - Brazzaville 2.1096 NOK
CDCongo - Kinshasa 2.9859 NOK
CKCook Islands 1.2257 NOK
CRCosta Rica 0.2975 NOK
HRCroatia 1.4010 NOK
CUCuba 0.8860 NOK
ANCuraçao 1.2982 NOK
CWCuraçao 2.9751 NOK
CYCyprus 1.0483 NOK
CZCzechia 0.5355 NOK
CICôte d’Ivoire 2.7587 NOK
DKDenmark 0.4987 NOK
DJDjibouti 1.2658 NOK
DMDominica 2.0447 NOK
DODominican Republic 1.3047 NOK
ECEcuador 2.8236 NOK
EGEgypt 3.0184 NOK
SVEl Salvador 1.2333 NOK
GQEquatorial Guinea 1.9473 NOK
EREritrea 1.0050 NOK
EEEstonia 0.5074 NOK
SZEswatini 1.6552 NOK
ETEthiopia 2.9751 NOK
FKFalkland Islands 0.7075 NOK
FOFaroe Islands 0.5171 NOK
FJFiji 1.8262 NOK
FIFinland 0.4544 NOK
FRFrance 0.5344 NOK
GFFrench Guiana 0.5799 NOK
PFFrench Polynesia 0.8709 NOK
GAGabon 2.9080 NOK
GMGambia 1.6909 NOK
GEGeorgia 1.3047 NOK
DEGermany 0.9423 NOK
GHGhana 2.3693 NOK
GIGibraltar 0.6902 NOK
GRGreece 0.4717 NOK
GLGreenland 0.1222 NOK
GDGrenada 2.4342 NOK
GPGuadeloupe 1.2009 NOK
GUGuam 1.3307 NOK
GTGuatemala 2.1096 NOK
GNGuinea 2.5964 NOK
GWGuinea-Bissau 2.4017 NOK
GYGuyana 2.5964 NOK
HTHaiti 2.6376 NOK
HNHonduras 1.4280 NOK
HKHong Kong SAR China 0.6069 NOK
HUHungary 0.7032 NOK
ISIceland 0.6826 NOK
INIndia 0.8060 NOK
IDIndonesia 4.3599 NOK
IRIran 3.6999 NOK
IQIraq 3.6383 NOK
IEIreland 0.4544 NOK
ILIsrael 2.1637 NOK
ITItaly 0.5171 NOK
JMJamaica 1.2917 NOK
JPJapan 0.5463 NOK
JOJordan 3.3754 NOK
KZKazakhstan 3.6512 NOK
KEKenya 1.2982 NOK
KIKiribati 0.5507 NOK
XKKosovo 2.7046 NOK
KWKuwait 3.1103 NOK
KGKyrgyzstan 2.7793 NOK
LALaos 1.3631 NOK
LVLatvia 0.5409 NOK
LBLebanon 0.5193 NOK
LSLesotho 2.5640 NOK
LRLiberia 1.9473 NOK
LYLibya 3.4489 NOK
LILiechtenstein 0.4317 NOK
LTLithuania 0.4392 NOK
LULuxembourg 1.1035 NOK
MOMacao SAR China 0.4760 NOK
MGMadagascar 4.2257 NOK
MWMalawi 2.8399 NOK
MYMalaysia 1.6228 NOK
MVMaldives 0.6816 NOK
MLMali 2.3043 NOK
MTMalta 0.5929 NOK
MHMarshall Islands 0.6091 NOK
MQMartinique 0.5409 NOK
MRMauritania 2.4666 NOK
MUMauritius 1.6715 NOK
MXMexico 0.7789 NOK
FMMicronesia 0.7984 NOK
MDMoldova 1.4421 NOK
MCMonaco 1.4216 NOK
MNMongolia 3.1785 NOK
MEMontenegro 1.5557 NOK
MSMontserrat 1.3631 NOK
MAMorocco 0.7789 NOK
MZMozambique 1.3631 NOK
MMMyanmar (Burma) 3.9899 NOK
NANamibia 0.4587 NOK
NRNauru 1.8262 NOK
NPNepal 2.6614 NOK
NLNetherlands 0.8255 NOK
NCNew Caledonia 1.2831 NOK
NZNew Zealand 0.4544 NOK
NINicaragua 1.2658 NOK
NENiger 3.0432 NOK
NGNigeria 3.6350 NOK
NUNiue 1.7580 NOK
KPNorth Korea 0.9077 NOK
MKNorth Macedonia 0.9531 NOK
NONorway 0.3895 NOK
OMOman 1.8932 NOK
PKPakistan 3.8947 NOK
PWPalau 1.2387 NOK
PSPalestinian Territories 3.1979 NOK
PAPanama 1.5903 NOK
PGPapua New Guinea 2.0966 NOK
PYParaguay 0.9088 NOK
PEPeru 1.3631 NOK
PHPhilippines 2.2924 NOK
PLPoland 0.2705 NOK
PTPortugal 0.2845 NOK
PRPuerto Rico 1.1305 NOK
QAQatar 1.1359 NOK
RORomania 0.5009 NOK
RURussia 4.3685 NOK
RWRwanda 3.0086 NOK
RERéunion 0.6816 NOK
WSSamoa 1.5254 NOK
SMSan Marino 0.6058 NOK
SASaudi Arabia 2.0772 NOK
SNSenegal 2.5640 NOK
RSSerbia 2.1096 NOK
SCSeychelles 1.1684 NOK
SLSierra Leone 2.5315 NOK
SGSingapore 0.4987 NOK
SXSint Maarten 1.0126 NOK
SKSlovakia 0.5496 NOK
SISlovenia 1.6909 NOK
SBSolomon Islands 0.9088 NOK
SOSomalia 2.3043 NOK
ZASouth Africa 0.5193 NOK
KRSouth Korea 0.2164 NOK
SSSouth Sudan 2.8399 NOK
ESSpain 0.4003 NOK
LKSri Lanka 4.0504 NOK
SHSt. Helena 1.0148 NOK
KNSt. Kitts & Nevis 2.6376 NOK
LCSt. Lucia 2.5640 NOK
PMSt. Pierre & Miquelon 1.2982 NOK
VCSt. Vincent & Grenadines 2.0447 NOK
SDSudan 3.3137 NOK
SRSuriname 2.3693 NOK
SESweden 0.5247 NOK
CHSwitzerland 0.6426 NOK
SYSyria 3.1850 NOK
STSão Tomé & Príncipe 0.2596 NOK
TWTaiwan 0.8114 NOK
TJTajikistan 3.9033 NOK
TZTanzania 2.9080 NOK
THThailand 0.1893 NOK
TLTimor-Leste 1.5903 NOK
TGTogo 1.8824 NOK
TKTokelau 0.2705 NOK
TOTonga 1.8262 NOK
TTTrinidad & Tobago 2.5640 NOK
TNTunisia 3.1157 NOK
TMTurkmenistan 2.3671 NOK
TCTurks & Caicos Islands 1.7245 NOK
TVTuvalu 1.6909 NOK
TRTürkiye 0.0822 NOK
VIU.S. Virgin Islands 0.3992 NOK
UGUganda 3.0562 NOK
UAUkraine 1.8932 NOK
AEUnited Arab Emirates 0.9877 NOK
GBUnited Kingdom 0.4338 NOK
USUnited States 0.2272 NOK
ZZUnknown Region 0.8925 NOK
UYUruguay 1.1500 NOK
UZUzbekistan 4.1922 NOK
VUVanuatu 1.7851 NOK
VEVenezuela 1.4280 NOK
VNVietnam 2.4006 NOK
WFWallis & Futuna 0.8017 NOK
YEYemen 1.8662 NOK
ZMZambia 2.8334 NOK
ZWZimbabwe 1.9679 NOK