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.5534 CAD
ALAlbania 0.1772 CAD
DZAlgeria 0.4507 CAD
ASAmerican Samoa 0.1891 CAD
ADAndorra 0.1341 CAD
AOAngola 0.1255 CAD
AIAnguilla 0.2608 CAD
AGAntigua & Barbuda 0.3573 CAD
ARArgentina 0.1458 CAD
AMArmenia 0.3420 CAD
AWAruba 0.2125 CAD
AUAustralia 0.0488 CAD
ATAustria 0.0837 CAD
AZAzerbaijan 0.5003 CAD
BSBahamas 0.1177 CAD
BHBahrain 0.0676 CAD
BDBangladesh 0.7395 CAD
BBBarbados 0.3924 CAD
BYBelarus 0.2838 CAD
BEBelgium 0.1304 CAD
BZBelize 0.3350 CAD
BJBenin 0.3572 CAD
BMBermuda 0.3924 CAD
BTBhutan 0.5030 CAD
BOBolivia 0.3332 CAD
BABosnia & Herzegovina 0.2270 CAD
BWBotswana 0.2113 CAD
BRBrazil 0.0404 CAD
IOBritish Indian Ocean Territory 0.1835 CAD
VGBritish Virgin Islands 0.3924 CAD
BNBrunei 0.0906 CAD
BGBulgaria 0.2213 CAD
BFBurkina Faso 0.2946 CAD
BIBurundi 0.6374 CAD
KHCambodia 0.4829 CAD
CMCameroon 0.3960 CAD
CACanada 0.0338 CAD
CVCape Verde 0.3068 CAD
KYCayman Islands 0.3622 CAD
CFCentral African Republic 0.1400 CAD
TDChad 0.4677 CAD
CLChile 0.0658 CAD
CNChina 0.0383 CAD
COColombia 0.0303 CAD
KMComoros 0.5119 CAD
CGCongo - Brazzaville 0.3139 CAD
CDCongo - Kinshasa 0.4442 CAD
CKCook Islands 0.1824 CAD
CRCosta Rica 0.0443 CAD
HRCroatia 0.2084 CAD
CUCuba 0.1318 CAD
ANCuraçao 0.1932 CAD
CWCuraçao 0.4426 CAD
CYCyprus 0.1560 CAD
CZCzechia 0.0797 CAD
CICôte d’Ivoire 0.4104 CAD
DKDenmark 0.0742 CAD
DJDjibouti 0.1883 CAD
DMDominica 0.3042 CAD
DODominican Republic 0.1941 CAD
ECEcuador 0.4201 CAD
EGEgypt 0.4491 CAD
SVEl Salvador 0.1835 CAD
GQEquatorial Guinea 0.2897 CAD
EREritrea 0.1495 CAD
EEEstonia 0.0755 CAD
SZEswatini 0.2463 CAD
ETEthiopia 0.4426 CAD
FKFalkland Islands 0.1053 CAD
FOFaroe Islands 0.0769 CAD
FJFiji 0.2717 CAD
FIFinland 0.0676 CAD
FRFrance 0.0795 CAD
GFFrench Guiana 0.0863 CAD
PFFrench Polynesia 0.1296 CAD
GAGabon 0.4327 CAD
GMGambia 0.2516 CAD
GEGeorgia 0.1941 CAD
DEGermany 0.1402 CAD
GHGhana 0.3525 CAD
GIGibraltar 0.1027 CAD
GRGreece 0.0702 CAD
GLGreenland 0.0182 CAD
GDGrenada 0.3622 CAD
GPGuadeloupe 0.1787 CAD
GUGuam 0.1980 CAD
GTGuatemala 0.3139 CAD
GNGuinea 0.3863 CAD
GWGuinea-Bissau 0.3573 CAD
GYGuyana 0.3863 CAD
HTHaiti 0.3924 CAD
HNHonduras 0.2125 CAD
HKHong Kong SAR China 0.0903 CAD
HUHungary 0.1046 CAD
ISIceland 0.1016 CAD
INIndia 0.1199 CAD
IDIndonesia 0.6487 CAD
IRIran 0.5505 CAD
IQIraq 0.5413 CAD
IEIreland 0.0676 CAD
ILIsrael 0.3219 CAD
ITItaly 0.0769 CAD
JMJamaica 0.1922 CAD
JPJapan 0.0813 CAD
JOJordan 0.5022 CAD
KZKazakhstan 0.5432 CAD
KEKenya 0.1932 CAD
KIKiribati 0.0819 CAD
XKKosovo 0.4024 CAD
KWKuwait 0.4628 CAD
KGKyrgyzstan 0.4135 CAD
LALaos 0.2028 CAD
LVLatvia 0.0805 CAD
LBLebanon 0.0773 CAD
LSLesotho 0.3815 CAD
LRLiberia 0.2897 CAD
LYLibya 0.5131 CAD
LILiechtenstein 0.0642 CAD
LTLithuania 0.0653 CAD
LULuxembourg 0.1642 CAD
MOMacao SAR China 0.0708 CAD
MGMadagascar 0.6287 CAD
MWMalawi 0.4225 CAD
MYMalaysia 0.2414 CAD
MVMaldives 0.1014 CAD
MLMali 0.3428 CAD
MTMalta 0.0882 CAD
MHMarshall Islands 0.0906 CAD
MQMartinique 0.0805 CAD
MRMauritania 0.3670 CAD
MUMauritius 0.2487 CAD
MXMexico 0.1159 CAD
FMMicronesia 0.1188 CAD
MDMoldova 0.2146 CAD
MCMonaco 0.2115 CAD
MNMongolia 0.4729 CAD
MEMontenegro 0.2315 CAD
MSMontserrat 0.2028 CAD
MAMorocco 0.1159 CAD
MZMozambique 0.2028 CAD
MMMyanmar (Burma) 0.5936 CAD
NANamibia 0.0682 CAD
NRNauru 0.2717 CAD
NPNepal 0.3960 CAD
NLNetherlands 0.1228 CAD
NCNew Caledonia 0.1909 CAD
NZNew Zealand 0.0676 CAD
NINicaragua 0.1883 CAD
NENiger 0.4528 CAD
NGNigeria 0.5408 CAD
NUNiue 0.2616 CAD
KPNorth Korea 0.1350 CAD
MKNorth Macedonia 0.1418 CAD
NONorway 0.0579 CAD
OMOman 0.2817 CAD
PKPakistan 0.5795 CAD
PWPalau 0.1843 CAD
PSPalestinian Territories 0.4758 CAD
PAPanama 0.2366 CAD
PGPapua New Guinea 0.3119 CAD
PYParaguay 0.1352 CAD
PEPeru 0.2028 CAD
PHPhilippines 0.3411 CAD
PLPoland 0.0402 CAD
PTPortugal 0.0423 CAD
PRPuerto Rico 0.1682 CAD
QAQatar 0.1690 CAD
RORomania 0.0745 CAD
RURussia 0.6500 CAD
RWRwanda 0.4476 CAD
RERéunion 0.1014 CAD
WSSamoa 0.2270 CAD
SMSan Marino 0.0901 CAD
SASaudi Arabia 0.3090 CAD
SNSenegal 0.3815 CAD
RSSerbia 0.3139 CAD
SCSeychelles 0.1738 CAD
SLSierra Leone 0.3766 CAD
SGSingapore 0.0742 CAD
SXSint Maarten 0.1507 CAD
SKSlovakia 0.0818 CAD
SISlovenia 0.2516 CAD
SBSolomon Islands 0.1352 CAD
SOSomalia 0.3428 CAD
ZASouth Africa 0.0773 CAD
KRSouth Korea 0.0322 CAD
SSSouth Sudan 0.4225 CAD
ESSpain 0.0596 CAD
LKSri Lanka 0.6026 CAD
SHSt. Helena 0.1510 CAD
KNSt. Kitts & Nevis 0.3924 CAD
LCSt. Lucia 0.3815 CAD
PMSt. Pierre & Miquelon 0.1932 CAD
VCSt. Vincent & Grenadines 0.3042 CAD
SDSudan 0.4930 CAD
SRSuriname 0.3525 CAD
SESweden 0.0781 CAD
CHSwitzerland 0.0956 CAD
SYSyria 0.4739 CAD
STSão Tomé & Príncipe 0.0386 CAD
TWTaiwan 0.1207 CAD
TJTajikistan 0.5807 CAD
TZTanzania 0.4327 CAD
THThailand 0.0282 CAD
TLTimor-Leste 0.2366 CAD
TGTogo 0.2801 CAD
TKTokelau 0.0402 CAD
TOTonga 0.2717 CAD
TTTrinidad & Tobago 0.3815 CAD
TNTunisia 0.4636 CAD
TMTurkmenistan 0.3522 CAD
TCTurks & Caicos Islands 0.2566 CAD
TVTuvalu 0.2516 CAD
TRTürkiye 0.0122 CAD
VIU.S. Virgin Islands 0.0594 CAD
UGUganda 0.4547 CAD
UAUkraine 0.2817 CAD
AEUnited Arab Emirates 0.1470 CAD
GBUnited Kingdom 0.0645 CAD
USUnited States 0.0338 CAD
ZZUnknown Region 0.1328 CAD
UYUruguay 0.1711 CAD
UZUzbekistan 0.6237 CAD
VUVanuatu 0.2656 CAD
VEVenezuela 0.2125 CAD
VNVietnam 0.3572 CAD
WFWallis & Futuna 0.1193 CAD
YEYemen 0.2777 CAD
ZMZambia 0.4216 CAD
ZWZimbabwe 0.2928 CAD