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.7239 NOK
ALAlbania 1.1925 NOK
DZAlgeria 3.0328 NOK
ASAmerican Samoa 1.2727 NOK
ADAndorra 0.9023 NOK
AOAngola 0.8449 NOK
AIAnguilla 1.7547 NOK
AGAntigua & Barbuda 2.4046 NOK
ARArgentina 0.9813 NOK
AMArmenia 2.3017 NOK
AWAruba 1.4298 NOK
AUAustralia 0.3282 NOK
ATAustria 0.5632 NOK
AZAzerbaijan 3.3664 NOK
BSBahamas 0.7918 NOK
BHBahrain 0.4549 NOK
BDBangladesh 4.9760 NOK
BBBarbados 2.6407 NOK
BYBelarus 1.9096 NOK
BEBelgium 0.8774 NOK
BZBelize 2.2540 NOK
BJBenin 2.4035 NOK
BMBermuda 2.6407 NOK
BTBhutan 3.3848 NOK
BOBolivia 2.2421 NOK
BABosnia & Herzegovina 1.5272 NOK
BWBotswana 1.4222 NOK
BRBrazil 0.2719 NOK
IOBritish Indian Ocean Territory 1.2348 NOK
VGBritish Virgin Islands 2.6407 NOK
BNBrunei 0.6098 NOK
BGBulgaria 1.4893 NOK
BFBurkina Faso 1.9822 NOK
BIBurundi 4.2893 NOK
KHCambodia 3.2495 NOK
CMCameroon 2.6645 NOK
CACanada 0.2275 NOK
CVCape Verde 2.0645 NOK
KYCayman Islands 2.4371 NOK
CFCentral African Republic 0.9423 NOK
TDChad 3.1476 NOK
CLChile 0.4430 NOK
CNChina 0.2578 NOK
COColombia 0.2036 NOK
KMComoros 3.4444 NOK
CGCongo - Brazzaville 2.1121 NOK
CDCongo - Kinshasa 2.9895 NOK
CKCook Islands 1.2272 NOK
CRCosta Rica 0.2979 NOK
HRCroatia 1.4027 NOK
CUCuba 0.8871 NOK
ANCuraçao 1.2998 NOK
CWCuraçao 2.9787 NOK
CYCyprus 1.0496 NOK
CZCzechia 0.5362 NOK
CICôte d’Ivoire 2.7620 NOK
DKDenmark 0.4993 NOK
DJDjibouti 1.2673 NOK
DMDominica 2.0472 NOK
DODominican Republic 1.3063 NOK
ECEcuador 2.8270 NOK
EGEgypt 3.0220 NOK
SVEl Salvador 1.2348 NOK
GQEquatorial Guinea 1.9497 NOK
EREritrea 1.0062 NOK
EEEstonia 0.5080 NOK
SZEswatini 1.6572 NOK
ETEthiopia 2.9787 NOK
FKFalkland Islands 0.7084 NOK
FOFaroe Islands 0.5177 NOK
FJFiji 1.8284 NOK
FIFinland 0.4549 NOK
FRFrance 0.5351 NOK
GFFrench Guiana 0.5806 NOK
PFFrench Polynesia 0.8719 NOK
GAGabon 2.9115 NOK
GMGambia 1.6930 NOK
GEGeorgia 1.3063 NOK
DEGermany 0.9434 NOK
GHGhana 2.3721 NOK
GIGibraltar 0.6910 NOK
GRGreece 0.4723 NOK
GLGreenland 0.1224 NOK
GDGrenada 2.4371 NOK
GPGuadeloupe 1.2023 NOK
GUGuam 1.3323 NOK
GTGuatemala 2.1121 NOK
GNGuinea 2.5996 NOK
GWGuinea-Bissau 2.4046 NOK
GYGuyana 2.5996 NOK
HTHaiti 2.6407 NOK
HNHonduras 1.4298 NOK
HKHong Kong SAR China 0.6076 NOK
HUHungary 0.7040 NOK
ISIceland 0.6835 NOK
INIndia 0.8069 NOK
IDIndonesia 4.3651 NOK
IRIran 3.7044 NOK
IQIraq 3.6426 NOK
IEIreland 0.4549 NOK
ILIsrael 2.1663 NOK
ITItaly 0.5177 NOK
JMJamaica 1.2933 NOK
JPJapan 0.5470 NOK
JOJordan 3.3794 NOK
KZKazakhstan 3.6556 NOK
KEKenya 1.2998 NOK
KIKiribati 0.5513 NOK
XKKosovo 2.7079 NOK
KWKuwait 3.1141 NOK
KGKyrgyzstan 2.7826 NOK
LALaos 1.3648 NOK
LVLatvia 0.5416 NOK
LBLebanon 0.5199 NOK
LSLesotho 2.5671 NOK
LRLiberia 1.9497 NOK
LYLibya 3.4531 NOK
LILiechtenstein 0.4322 NOK
LTLithuania 0.4398 NOK
LULuxembourg 1.1048 NOK
MOMacao SAR China 0.4766 NOK
MGMadagascar 4.2308 NOK
MWMalawi 2.8433 NOK
MYMalaysia 1.6247 NOK
MVMaldives 0.6824 NOK
MLMali 2.3071 NOK
MTMalta 0.5936 NOK
MHMarshall Islands 0.6098 NOK
MQMartinique 0.5416 NOK
MRMauritania 2.4696 NOK
MUMauritius 1.6735 NOK
MXMexico 0.7799 NOK
FMMicronesia 0.7994 NOK
MDMoldova 1.4438 NOK
MCMonaco 1.4233 NOK
MNMongolia 3.1823 NOK
MEMontenegro 1.5576 NOK
MSMontserrat 1.3648 NOK
MAMorocco 0.7799 NOK
MZMozambique 1.3648 NOK
MMMyanmar (Burma) 3.9947 NOK
NANamibia 0.4593 NOK
NRNauru 1.8284 NOK
NPNepal 2.6645 NOK
NLNetherlands 0.8264 NOK
NCNew Caledonia 1.2846 NOK
NZNew Zealand 0.4549 NOK
NINicaragua 1.2673 NOK
NENiger 3.0469 NOK
NGNigeria 3.6394 NOK
NUNiue 1.7601 NOK
KPNorth Korea 0.9088 NOK
MKNorth Macedonia 0.9543 NOK
NONorway 0.3899 NOK
OMOman 1.8955 NOK
PKPakistan 3.8993 NOK
PWPalau 1.2402 NOK
PSPalestinian Territories 3.2018 NOK
PAPanama 1.5922 NOK
PGPapua New Guinea 2.0991 NOK
PYParaguay 0.9098 NOK
PEPeru 1.3648 NOK
PHPhilippines 2.2952 NOK
PLPoland 0.2708 NOK
PTPortugal 0.2849 NOK
PRPuerto Rico 1.1319 NOK
QAQatar 1.1373 NOK
RORomania 0.5015 NOK
RURussia 4.3738 NOK
RWRwanda 3.0122 NOK
RERéunion 0.6824 NOK
WSSamoa 1.5272 NOK
SMSan Marino 0.6066 NOK
SASaudi Arabia 2.0796 NOK
SNSenegal 2.5671 NOK
RSSerbia 2.1121 NOK
SCSeychelles 1.1698 NOK
SLSierra Leone 2.5346 NOK
SGSingapore 0.4993 NOK
SXSint Maarten 1.0138 NOK
SKSlovakia 0.5502 NOK
SISlovenia 1.6930 NOK
SBSolomon Islands 0.9098 NOK
SOSomalia 2.3071 NOK
ZASouth Africa 0.5199 NOK
KRSouth Korea 0.2166 NOK
SSSouth Sudan 2.8433 NOK
ESSpain 0.4008 NOK
LKSri Lanka 4.0553 NOK
SHSt. Helena 1.0160 NOK
KNSt. Kitts & Nevis 2.6407 NOK
LCSt. Lucia 2.5671 NOK
PMSt. Pierre & Miquelon 1.2998 NOK
VCSt. Vincent & Grenadines 2.0472 NOK
SDSudan 3.3177 NOK
SRSuriname 2.3721 NOK
SESweden 0.5253 NOK
CHSwitzerland 0.6434 NOK
SYSyria 3.1888 NOK
STSão Tomé & Príncipe 0.2600 NOK
TWTaiwan 0.8124 NOK
TJTajikistan 3.9080 NOK
TZTanzania 2.9115 NOK
THThailand 0.1896 NOK
TLTimor-Leste 1.5922 NOK
TGTogo 1.8847 NOK
TKTokelau 0.2708 NOK
TOTonga 1.8284 NOK
TTTrinidad & Tobago 2.5671 NOK
TNTunisia 3.1195 NOK
TMTurkmenistan 2.3699 NOK
TCTurks & Caicos Islands 1.7265 NOK
TVTuvalu 1.6930 NOK
TRTürkiye 0.0823 NOK
VIU.S. Virgin Islands 0.3997 NOK
UGUganda 3.0599 NOK
UAUkraine 1.8955 NOK
AEUnited Arab Emirates 0.9889 NOK
GBUnited Kingdom 0.4343 NOK
USUnited States 0.2275 NOK
ZZUnknown Region 0.8936 NOK
UYUruguay 1.1514 NOK
UZUzbekistan 4.1972 NOK
VUVanuatu 1.7872 NOK
VEVenezuela 1.4298 NOK
VNVietnam 2.4035 NOK
WFWallis & Futuna 0.8026 NOK
YEYemen 1.8684 NOK
ZMZambia 2.8368 NOK
ZWZimbabwe 1.9702 NOK