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.8073 RON
ALAlbania 0.5788 RON
DZAlgeria 1.4719 RON
ASAmerican Samoa 0.6177 RON
ADAndorra 0.4379 RON
AOAngola 0.4100 RON
AIAnguilla 0.8516 RON
AGAntigua & Barbuda 1.1670 RON
ARArgentina 0.4763 RON
AMArmenia 1.1170 RON
AWAruba 0.6939 RON
AUAustralia 0.1593 RON
ATAustria 0.2733 RON
AZAzerbaijan 1.6338 RON
BSBahamas 0.3843 RON
BHBahrain 0.2208 RON
BDBangladesh 2.4149 RON
BBBarbados 1.2816 RON
BYBelarus 0.9268 RON
BEBelgium 0.4258 RON
BZBelize 1.0939 RON
BJBenin 1.1665 RON
BMBermuda 1.2816 RON
BTBhutan 1.6427 RON
BOBolivia 1.0881 RON
BABosnia & Herzegovina 0.7412 RON
BWBotswana 0.6902 RON
BRBrazil 0.1319 RON
IOBritish Indian Ocean Territory 0.5993 RON
VGBritish Virgin Islands 1.2816 RON
BNBrunei 0.2960 RON
BGBulgaria 0.7228 RON
BFBurkina Faso 0.9620 RON
BIBurundi 2.0817 RON
KHCambodia 1.5770 RON
CMCameroon 1.2931 RON
CACanada 0.1104 RON
CVCape Verde 1.0019 RON
KYCayman Islands 1.1828 RON
CFCentral African Republic 0.4573 RON
TDChad 1.5276 RON
CLChile 0.2150 RON
CNChina 0.1251 RON
COColombia 0.0988 RON
KMComoros 1.6716 RON
CGCongo - Brazzaville 1.0251 RON
CDCongo - Kinshasa 1.4508 RON
CKCook Islands 0.5956 RON
CRCosta Rica 0.1446 RON
HRCroatia 0.6807 RON
CUCuba 0.4305 RON
ANCuraçao 0.6308 RON
CWCuraçao 1.4456 RON
CYCyprus 0.5094 RON
CZCzechia 0.2602 RON
CICôte d’Ivoire 1.3405 RON
DKDenmark 0.2423 RON
DJDjibouti 0.6150 RON
DMDominica 0.9935 RON
DODominican Republic 0.6340 RON
ECEcuador 1.3720 RON
EGEgypt 1.4666 RON
SVEl Salvador 0.5993 RON
GQEquatorial Guinea 0.9462 RON
EREritrea 0.4883 RON
EEEstonia 0.2465 RON
SZEswatini 0.8043 RON
ETEthiopia 1.4456 RON
FKFalkland Islands 0.3438 RON
FOFaroe Islands 0.2513 RON
FJFiji 0.8873 RON
FIFinland 0.2208 RON
FRFrance 0.2597 RON
GFFrench Guiana 0.2818 RON
PFFrench Polynesia 0.4232 RON
GAGabon 1.4130 RON
GMGambia 0.8216 RON
GEGeorgia 0.6340 RON
DEGermany 0.4579 RON
GHGhana 1.1512 RON
GIGibraltar 0.3354 RON
GRGreece 0.2292 RON
GLGreenland 0.0594 RON
GDGrenada 1.1828 RON
GPGuadeloupe 0.5835 RON
GUGuam 0.6466 RON
GTGuatemala 1.0251 RON
GNGuinea 1.2616 RON
GWGuinea-Bissau 1.1670 RON
GYGuyana 1.2616 RON
HTHaiti 1.2816 RON
HNHonduras 0.6939 RON
HKHong Kong SAR China 0.2949 RON
HUHungary 0.3417 RON
ISIceland 0.3317 RON
INIndia 0.3916 RON
IDIndonesia 2.1185 RON
IRIran 1.7978 RON
IQIraq 1.7678 RON
IEIreland 0.2208 RON
ILIsrael 1.0513 RON
ITItaly 0.2513 RON
JMJamaica 0.6276 RON
JPJapan 0.2655 RON
JOJordan 1.6401 RON
KZKazakhstan 1.7741 RON
KEKenya 0.6308 RON
KIKiribati 0.2676 RON
XKKosovo 1.3142 RON
KWKuwait 1.5113 RON
KGKyrgyzstan 1.3504 RON
LALaos 0.6623 RON
LVLatvia 0.2628 RON
LBLebanon 0.2523 RON
LSLesotho 1.2458 RON
LRLiberia 0.9462 RON
LYLibya 1.6758 RON
LILiechtenstein 0.2097 RON
LTLithuania 0.2134 RON
LULuxembourg 0.5362 RON
MOMacao SAR China 0.2313 RON
MGMadagascar 2.0533 RON
MWMalawi 1.3799 RON
MYMalaysia 0.7885 RON
MVMaldives 0.3312 RON
MLMali 1.1197 RON
MTMalta 0.2881 RON
MHMarshall Islands 0.2960 RON
MQMartinique 0.2628 RON
MRMauritania 1.1985 RON
MUMauritius 0.8122 RON
MXMexico 0.3785 RON
FMMicronesia 0.3879 RON
MDMoldova 0.7007 RON
MCMonaco 0.6907 RON
MNMongolia 1.5444 RON
MEMontenegro 0.7559 RON
MSMontserrat 0.6623 RON
MAMorocco 0.3785 RON
MZMozambique 0.6623 RON
MMMyanmar (Burma) 1.9387 RON
NANamibia 0.2229 RON
NRNauru 0.8873 RON
NPNepal 1.2931 RON
NLNetherlands 0.4011 RON
NCNew Caledonia 0.6234 RON
NZNew Zealand 0.2208 RON
NINicaragua 0.6150 RON
NENiger 1.4787 RON
NGNigeria 1.7663 RON
NUNiue 0.8542 RON
KPNorth Korea 0.4410 RON
MKNorth Macedonia 0.4631 RON
NONorway 0.1892 RON
OMOman 0.9199 RON
PKPakistan 1.8924 RON
PWPalau 0.6019 RON
PSPalestinian Territories 1.5539 RON
PAPanama 0.7727 RON
PGPapua New Guinea 1.0187 RON
PYParaguay 0.4416 RON
PEPeru 0.6623 RON
PHPhilippines 1.1139 RON
PLPoland 0.1314 RON
PTPortugal 0.1383 RON
PRPuerto Rico 0.5493 RON
QAQatar 0.5520 RON
RORomania 0.2434 RON
RURussia 2.1227 RON
RWRwanda 1.4619 RON
RERéunion 0.3312 RON
WSSamoa 0.7412 RON
SMSan Marino 0.2944 RON
SASaudi Arabia 1.0093 RON
SNSenegal 1.2458 RON
RSSerbia 1.0251 RON
SCSeychelles 0.5677 RON
SLSierra Leone 1.2301 RON
SGSingapore 0.2423 RON
SXSint Maarten 0.4920 RON
SKSlovakia 0.2670 RON
SISlovenia 0.8216 RON
SBSolomon Islands 0.4416 RON
SOSomalia 1.1197 RON
ZASouth Africa 0.2523 RON
KRSouth Korea 0.1051 RON
SSSouth Sudan 1.3799 RON
ESSpain 0.1945 RON
LKSri Lanka 1.9681 RON
SHSt. Helena 0.4931 RON
KNSt. Kitts & Nevis 1.2816 RON
LCSt. Lucia 1.2458 RON
PMSt. Pierre & Miquelon 0.6308 RON
VCSt. Vincent & Grenadines 0.9935 RON
SDSudan 1.6101 RON
SRSuriname 1.1512 RON
SESweden 0.2549 RON
CHSwitzerland 0.3122 RON
SYSyria 1.5476 RON
STSão Tomé & Príncipe 0.1262 RON
TWTaiwan 0.3943 RON
TJTajikistan 1.8966 RON
TZTanzania 1.4130 RON
THThailand 0.0920 RON
TLTimor-Leste 0.7727 RON
TGTogo 0.9147 RON
TKTokelau 0.1314 RON
TOTonga 0.8873 RON
TTTrinidad & Tobago 1.2458 RON
TNTunisia 1.5139 RON
TMTurkmenistan 1.1502 RON
TCTurks & Caicos Islands 0.8379 RON
TVTuvalu 0.8216 RON
TRTürkiye 0.0400 RON
VIU.S. Virgin Islands 0.1940 RON
UGUganda 1.4850 RON
UAUkraine 0.9199 RON
AEUnited Arab Emirates 0.4799 RON
GBUnited Kingdom 0.2108 RON
USUnited States 0.1104 RON
ZZUnknown Region 0.4337 RON
UYUruguay 0.5588 RON
UZUzbekistan 2.0370 RON
VUVanuatu 0.8674 RON
VEVenezuela 0.6939 RON
VNVietnam 1.1665 RON
WFWallis & Futuna 0.3895 RON
YEYemen 0.9068 RON
ZMZambia 1.3767 RON
ZWZimbabwe 0.9562 RON