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 0.5495 CAD
ALAlbania 0.1760 CAD
DZAlgeria 0.4476 CAD
ASAmerican Samoa 0.1878 CAD
ADAndorra 0.1331 CAD
AOAngola 0.1247 CAD
AIAnguilla 0.2589 CAD
AGAntigua & Barbuda 0.3548 CAD
ARArgentina 0.1448 CAD
AMArmenia 0.3397 CAD
AWAruba 0.2110 CAD
AUAustralia 0.0484 CAD
ATAustria 0.0831 CAD
AZAzerbaijan 0.4968 CAD
BSBahamas 0.1168 CAD
BHBahrain 0.0671 CAD
BDBangladesh 0.7343 CAD
BBBarbados 0.3897 CAD
BYBelarus 0.2818 CAD
BEBelgium 0.1295 CAD
BZBelize 0.3326 CAD
BJBenin 0.3547 CAD
BMBermuda 0.3897 CAD
BTBhutan 0.4995 CAD
BOBolivia 0.3309 CAD
BABosnia & Herzegovina 0.2254 CAD
BWBotswana 0.2099 CAD
BRBrazil 0.0401 CAD
IOBritish Indian Ocean Territory 0.1822 CAD
VGBritish Virgin Islands 0.3897 CAD
BNBrunei 0.0900 CAD
BGBulgaria 0.2198 CAD
BFBurkina Faso 0.2925 CAD
BIBurundi 0.6330 CAD
KHCambodia 0.4795 CAD
CMCameroon 0.3932 CAD
CACanada 0.0336 CAD
CVCape Verde 0.3047 CAD
KYCayman Islands 0.3596 CAD
CFCentral African Republic 0.1391 CAD
TDChad 0.4645 CAD
CLChile 0.0654 CAD
CNChina 0.0380 CAD
COColombia 0.0300 CAD
KMComoros 0.5083 CAD
CGCongo - Brazzaville 0.3117 CAD
CDCongo - Kinshasa 0.4412 CAD
CKCook Islands 0.1811 CAD
CRCosta Rica 0.0440 CAD
HRCroatia 0.2070 CAD
CUCuba 0.1309 CAD
ANCuraçao 0.1918 CAD
CWCuraçao 0.4396 CAD
CYCyprus 0.1549 CAD
CZCzechia 0.0791 CAD
CICôte d’Ivoire 0.4076 CAD
DKDenmark 0.0737 CAD
DJDjibouti 0.1870 CAD
DMDominica 0.3021 CAD
DODominican Republic 0.1928 CAD
ECEcuador 0.4172 CAD
EGEgypt 0.4460 CAD
SVEl Salvador 0.1822 CAD
GQEquatorial Guinea 0.2877 CAD
EREritrea 0.1485 CAD
EEEstonia 0.0750 CAD
SZEswatini 0.2446 CAD
ETEthiopia 0.4396 CAD
FKFalkland Islands 0.1045 CAD
FOFaroe Islands 0.0764 CAD
FJFiji 0.2698 CAD
FIFinland 0.0671 CAD
FRFrance 0.0790 CAD
GFFrench Guiana 0.0857 CAD
PFFrench Polynesia 0.1287 CAD
GAGabon 0.4296 CAD
GMGambia 0.2498 CAD
GEGeorgia 0.1928 CAD
DEGermany 0.1392 CAD
GHGhana 0.3500 CAD
GIGibraltar 0.1020 CAD
GRGreece 0.0697 CAD
GLGreenland 0.0181 CAD
GDGrenada 0.3596 CAD
GPGuadeloupe 0.1774 CAD
GUGuam 0.1966 CAD
GTGuatemala 0.3117 CAD
GNGuinea 0.3836 CAD
GWGuinea-Bissau 0.3548 CAD
GYGuyana 0.3836 CAD
HTHaiti 0.3897 CAD
HNHonduras 0.2110 CAD
HKHong Kong SAR China 0.0897 CAD
HUHungary 0.1039 CAD
ISIceland 0.1009 CAD
INIndia 0.1191 CAD
IDIndonesia 0.6442 CAD
IRIran 0.5467 CAD
IQIraq 0.5375 CAD
IEIreland 0.0671 CAD
ILIsrael 0.3197 CAD
ITItaly 0.0764 CAD
JMJamaica 0.1908 CAD
JPJapan 0.0807 CAD
JOJordan 0.4987 CAD
KZKazakhstan 0.5395 CAD
KEKenya 0.1918 CAD
KIKiribati 0.0814 CAD
XKKosovo 0.3996 CAD
KWKuwait 0.4595 CAD
KGKyrgyzstan 0.4106 CAD
LALaos 0.2014 CAD
LVLatvia 0.0799 CAD
LBLebanon 0.0767 CAD
LSLesotho 0.3788 CAD
LRLiberia 0.2877 CAD
LYLibya 0.5096 CAD
LILiechtenstein 0.0638 CAD
LTLithuania 0.0649 CAD
LULuxembourg 0.1630 CAD
MOMacao SAR China 0.0703 CAD
MGMadagascar 0.6243 CAD
MWMalawi 0.4196 CAD
MYMalaysia 0.2398 CAD
MVMaldives 0.1007 CAD
MLMali 0.3405 CAD
MTMalta 0.0876 CAD
MHMarshall Islands 0.0900 CAD
MQMartinique 0.0799 CAD
MRMauritania 0.3644 CAD
MUMauritius 0.2470 CAD
MXMexico 0.1151 CAD
FMMicronesia 0.1180 CAD
MDMoldova 0.2131 CAD
MCMonaco 0.2100 CAD
MNMongolia 0.4696 CAD
MEMontenegro 0.2298 CAD
MSMontserrat 0.2014 CAD
MAMorocco 0.1151 CAD
MZMozambique 0.2014 CAD
MMMyanmar (Burma) 0.5895 CAD
NANamibia 0.0678 CAD
NRNauru 0.2698 CAD
NPNepal 0.3932 CAD
NLNetherlands 0.1220 CAD
NCNew Caledonia 0.1896 CAD
NZNew Zealand 0.0671 CAD
NINicaragua 0.1870 CAD
NENiger 0.4496 CAD
NGNigeria 0.5371 CAD
NUNiue 0.2597 CAD
KPNorth Korea 0.1341 CAD
MKNorth Macedonia 0.1408 CAD
NONorway 0.0575 CAD
OMOman 0.2797 CAD
PKPakistan 0.5754 CAD
PWPalau 0.1830 CAD
PSPalestinian Territories 0.4725 CAD
PAPanama 0.2350 CAD
PGPapua New Guinea 0.3098 CAD
PYParaguay 0.1343 CAD
PEPeru 0.2014 CAD
PHPhilippines 0.3387 CAD
PLPoland 0.0400 CAD
PTPortugal 0.0420 CAD
PRPuerto Rico 0.1670 CAD
QAQatar 0.1678 CAD
RORomania 0.0740 CAD
RURussia 0.6454 CAD
RWRwanda 0.4445 CAD
RERéunion 0.1007 CAD
WSSamoa 0.2254 CAD
SMSan Marino 0.0895 CAD
SASaudi Arabia 0.3069 CAD
SNSenegal 0.3788 CAD
RSSerbia 0.3117 CAD
SCSeychelles 0.1726 CAD
SLSierra Leone 0.3740 CAD
SGSingapore 0.0737 CAD
SXSint Maarten 0.1496 CAD
SKSlovakia 0.0812 CAD
SISlovenia 0.2498 CAD
SBSolomon Islands 0.1343 CAD
SOSomalia 0.3405 CAD
ZASouth Africa 0.0767 CAD
KRSouth Korea 0.0320 CAD
SSSouth Sudan 0.4196 CAD
ESSpain 0.0591 CAD
LKSri Lanka 0.5984 CAD
SHSt. Helena 0.1499 CAD
KNSt. Kitts & Nevis 0.3897 CAD
LCSt. Lucia 0.3788 CAD
PMSt. Pierre & Miquelon 0.1918 CAD
VCSt. Vincent & Grenadines 0.3021 CAD
SDSudan 0.4896 CAD
SRSuriname 0.3500 CAD
SESweden 0.0775 CAD
CHSwitzerland 0.0949 CAD
SYSyria 0.4706 CAD
STSão Tomé & Príncipe 0.0384 CAD
TWTaiwan 0.1199 CAD
TJTajikistan 0.5767 CAD
TZTanzania 0.4296 CAD
THThailand 0.0280 CAD
TLTimor-Leste 0.2350 CAD
TGTogo 0.2781 CAD
TKTokelau 0.0400 CAD
TOTonga 0.2698 CAD
TTTrinidad & Tobago 0.3788 CAD
TNTunisia 0.4603 CAD
TMTurkmenistan 0.3497 CAD
TCTurks & Caicos Islands 0.2548 CAD
TVTuvalu 0.2498 CAD
TRTürkiye 0.0121 CAD
VIU.S. Virgin Islands 0.0590 CAD
UGUganda 0.4515 CAD
UAUkraine 0.2797 CAD
AEUnited Arab Emirates 0.1459 CAD
GBUnited Kingdom 0.0641 CAD
USUnited States 0.0336 CAD
ZZUnknown Region 0.1319 CAD
UYUruguay 0.1699 CAD
UZUzbekistan 0.6194 CAD
VUVanuatu 0.2637 CAD
VEVenezuela 0.2110 CAD
VNVietnam 0.3547 CAD
WFWallis & Futuna 0.1184 CAD
YEYemen 0.2757 CAD
ZMZambia 0.4186 CAD
ZWZimbabwe 0.2907 CAD