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.8212 SEK
ALAlbania 1.2237 SEK
DZAlgeria 3.1121 SEK
ASAmerican Samoa 1.3060 SEK
ADAndorra 0.9258 SEK
AOAngola 0.8669 SEK
AIAnguilla 1.8005 SEK
AGAntigua & Barbuda 2.4674 SEK
ARArgentina 1.0070 SEK
AMArmenia 2.3618 SEK
AWAruba 1.4671 SEK
AUAustralia 0.3368 SEK
ATAustria 0.5780 SEK
AZAzerbaijan 3.4544 SEK
BSBahamas 0.8125 SEK
BHBahrain 0.4668 SEK
BDBangladesh 5.1060 SEK
BBBarbados 2.7097 SEK
BYBelarus 1.9595 SEK
BEBelgium 0.9003 SEK
BZBelize 2.3129 SEK
BJBenin 2.4663 SEK
BMBermuda 2.7097 SEK
BTBhutan 3.4733 SEK
BOBolivia 2.3007 SEK
BABosnia & Herzegovina 1.5671 SEK
BWBotswana 1.4593 SEK
BRBrazil 0.2790 SEK
IOBritish Indian Ocean Territory 1.2671 SEK
VGBritish Virgin Islands 2.7097 SEK
BNBrunei 0.6257 SEK
BGBulgaria 1.5282 SEK
BFBurkina Faso 2.0340 SEK
BIBurundi 4.4013 SEK
KHCambodia 3.3343 SEK
CMCameroon 2.7342 SEK
CACanada 0.2334 SEK
CVCape Verde 2.1184 SEK
KYCayman Islands 2.5008 SEK
CFCentral African Republic 0.9670 SEK
TDChad 3.2299 SEK
CLChile 0.4546 SEK
CNChina 0.2645 SEK
COColombia 0.2090 SEK
KMComoros 3.5344 SEK
CGCongo - Brazzaville 2.1673 SEK
CDCongo - Kinshasa 3.0676 SEK
CKCook Islands 1.2593 SEK
CRCosta Rica 0.3056 SEK
HRCroatia 1.4393 SEK
CUCuba 0.9103 SEK
ANCuraçao 1.3337 SEK
CWCuraçao 3.0565 SEK
CYCyprus 1.0770 SEK
CZCzechia 0.5502 SEK
CICôte d’Ivoire 2.8342 SEK
DKDenmark 0.5124 SEK
DJDjibouti 1.3004 SEK
DMDominica 2.1006 SEK
DODominican Republic 1.3404 SEK
ECEcuador 2.9009 SEK
EGEgypt 3.1009 SEK
SVEl Salvador 1.2671 SEK
GQEquatorial Guinea 2.0006 SEK
EREritrea 1.0325 SEK
EEEstonia 0.5213 SEK
SZEswatini 1.7005 SEK
ETEthiopia 3.0565 SEK
FKFalkland Islands 0.7269 SEK
FOFaroe Islands 0.5313 SEK
FJFiji 1.8761 SEK
FIFinland 0.4668 SEK
FRFrance 0.5491 SEK
GFFrench Guiana 0.5957 SEK
PFFrench Polynesia 0.8947 SEK
GAGabon 2.9876 SEK
GMGambia 1.7372 SEK
GEGeorgia 1.3404 SEK
DEGermany 0.9681 SEK
GHGhana 2.4341 SEK
GIGibraltar 0.7091 SEK
GRGreece 0.4846 SEK
GLGreenland 0.1256 SEK
GDGrenada 2.5008 SEK
GPGuadeloupe 1.2337 SEK
GUGuam 1.3671 SEK
GTGuatemala 2.1673 SEK
GNGuinea 2.6675 SEK
GWGuinea-Bissau 2.4674 SEK
GYGuyana 2.6675 SEK
HTHaiti 2.7097 SEK
HNHonduras 1.4671 SEK
HKHong Kong SAR China 0.6235 SEK
HUHungary 0.7224 SEK
ISIceland 0.7013 SEK
INIndia 0.8280 SEK
IDIndonesia 4.4791 SEK
IRIran 3.8012 SEK
IQIraq 3.7378 SEK
IEIreland 0.4668 SEK
ILIsrael 2.2229 SEK
ITItaly 0.5313 SEK
JMJamaica 1.3271 SEK
JPJapan 0.5613 SEK
JOJordan 3.4677 SEK
KZKazakhstan 3.7511 SEK
KEKenya 1.3337 SEK
KIKiribati 0.5657 SEK
XKKosovo 2.7786 SEK
KWKuwait 3.1954 SEK
KGKyrgyzstan 2.8553 SEK
LALaos 1.4004 SEK
LVLatvia 0.5557 SEK
LBLebanon 0.5335 SEK
LSLesotho 2.6341 SEK
LRLiberia 2.0006 SEK
LYLibya 3.5433 SEK
LILiechtenstein 0.4435 SEK
LTLithuania 0.4512 SEK
LULuxembourg 1.1337 SEK
MOMacao SAR China 0.4890 SEK
MGMadagascar 4.3413 SEK
MWMalawi 2.9176 SEK
MYMalaysia 1.6672 SEK
MVMaldives 0.7002 SEK
MLMali 2.3674 SEK
MTMalta 0.6091 SEK
MHMarshall Islands 0.6257 SEK
MQMartinique 0.5557 SEK
MRMauritania 2.5341 SEK
MUMauritius 1.7172 SEK
MXMexico 0.8002 SEK
FMMicronesia 0.8203 SEK
MDMoldova 1.4816 SEK
MCMonaco 1.4604 SEK
MNMongolia 3.2654 SEK
MEMontenegro 1.5983 SEK
MSMontserrat 1.4004 SEK
MAMorocco 0.8002 SEK
MZMozambique 1.4004 SEK
MMMyanmar (Burma) 4.0990 SEK
NANamibia 0.4713 SEK
NRNauru 1.8761 SEK
NPNepal 2.7342 SEK
NLNetherlands 0.8480 SEK
NCNew Caledonia 1.3182 SEK
NZNew Zealand 0.4668 SEK
NINicaragua 1.3004 SEK
NENiger 3.1265 SEK
NGNigeria 3.7345 SEK
NUNiue 1.8061 SEK
KPNorth Korea 0.9325 SEK
MKNorth Macedonia 0.9792 SEK
NONorway 0.4001 SEK
OMOman 1.9450 SEK
PKPakistan 4.0012 SEK
PWPalau 1.2726 SEK
PSPalestinian Territories 3.2854 SEK
PAPanama 1.6338 SEK
PGPapua New Guinea 2.1540 SEK
PYParaguay 0.9336 SEK
PEPeru 1.4004 SEK
PHPhilippines 2.3552 SEK
PLPoland 0.2779 SEK
PTPortugal 0.2923 SEK
PRPuerto Rico 1.1615 SEK
QAQatar 1.1670 SEK
RORomania 0.5146 SEK
RURussia 4.4880 SEK
RWRwanda 3.0909 SEK
RERéunion 0.7002 SEK
WSSamoa 1.5671 SEK
SMSan Marino 0.6224 SEK
SASaudi Arabia 2.1340 SEK
SNSenegal 2.6341 SEK
RSSerbia 2.1673 SEK
SCSeychelles 1.2004 SEK
SLSierra Leone 2.6008 SEK
SGSingapore 0.5124 SEK
SXSint Maarten 1.0403 SEK
SKSlovakia 0.5646 SEK
SISlovenia 1.7372 SEK
SBSolomon Islands 0.9336 SEK
SOSomalia 2.3674 SEK
ZASouth Africa 0.5335 SEK
KRSouth Korea 0.2223 SEK
SSSouth Sudan 2.9176 SEK
ESSpain 0.4112 SEK
LKSri Lanka 4.1613 SEK
SHSt. Helena 1.0425 SEK
KNSt. Kitts & Nevis 2.7097 SEK
LCSt. Lucia 2.6341 SEK
PMSt. Pierre & Miquelon 1.3337 SEK
VCSt. Vincent & Grenadines 2.1006 SEK
SDSudan 3.4044 SEK
SRSuriname 2.4341 SEK
SESweden 0.5391 SEK
CHSwitzerland 0.6602 SEK
SYSyria 3.2721 SEK
STSão Tomé & Príncipe 0.2667 SEK
TWTaiwan 0.8336 SEK
TJTajikistan 4.0101 SEK
TZTanzania 2.9876 SEK
THThailand 0.1945 SEK
TLTimor-Leste 1.6338 SEK
TGTogo 1.9339 SEK
TKTokelau 0.2779 SEK
TOTonga 1.8761 SEK
TTTrinidad & Tobago 2.6341 SEK
TNTunisia 3.2010 SEK
TMTurkmenistan 2.4319 SEK
TCTurks & Caicos Islands 1.7717 SEK
TVTuvalu 1.7372 SEK
TRTürkiye 0.0845 SEK
VIU.S. Virgin Islands 0.4101 SEK
UGUganda 3.1398 SEK
UAUkraine 1.9450 SEK
AEUnited Arab Emirates 1.0148 SEK
GBUnited Kingdom 0.4457 SEK
USUnited States 0.2334 SEK
ZZUnknown Region 0.9169 SEK
UYUruguay 1.1815 SEK
UZUzbekistan 4.3069 SEK
VUVanuatu 1.8339 SEK
VEVenezuela 1.4671 SEK
VNVietnam 2.4663 SEK
WFWallis & Futuna 0.8236 SEK
YEYemen 1.9173 SEK
ZMZambia 2.9109 SEK
ZWZimbabwe 2.0217 SEK