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.3985 USD
ALAlbania 0.1276 USD
DZAlgeria 0.3245 USD
ASAmerican Samoa 0.1362 USD
ADAndorra 0.0965 USD
AOAngola 0.0904 USD
AIAnguilla 0.1878 USD
AGAntigua & Barbuda 0.2573 USD
ARArgentina 0.1050 USD
AMArmenia 0.2463 USD
AWAruba 0.1530 USD
AUAustralia 0.0351 USD
ATAustria 0.0603 USD
AZAzerbaijan 0.3602 USD
BSBahamas 0.0847 USD
BHBahrain 0.0487 USD
BDBangladesh 0.5324 USD
BBBarbados 0.2826 USD
BYBelarus 0.2043 USD
BEBelgium 0.0939 USD
BZBelize 0.2412 USD
BJBenin 0.2572 USD
BMBermuda 0.2826 USD
BTBhutan 0.3622 USD
BOBolivia 0.2399 USD
BABosnia & Herzegovina 0.1634 USD
BWBotswana 0.1522 USD
BRBrazil 0.0291 USD
IOBritish Indian Ocean Territory 0.1321 USD
VGBritish Virgin Islands 0.2826 USD
BNBrunei 0.0653 USD
BGBulgaria 0.1594 USD
BFBurkina Faso 0.2121 USD
BIBurundi 0.4590 USD
KHCambodia 0.3477 USD
CMCameroon 0.2851 USD
CACanada 0.0243 USD
CVCape Verde 0.2209 USD
KYCayman Islands 0.2608 USD
CFCentral African Republic 0.1008 USD
TDChad 0.3368 USD
CLChile 0.0474 USD
CNChina 0.0276 USD
COColombia 0.0218 USD
KMComoros 0.3686 USD
CGCongo - Brazzaville 0.2260 USD
CDCongo - Kinshasa 0.3199 USD
CKCook Islands 0.1313 USD
CRCosta Rica 0.0319 USD
HRCroatia 0.1501 USD
CUCuba 0.0949 USD
ANCuraçao 0.1391 USD
CWCuraçao 0.3187 USD
CYCyprus 0.1123 USD
CZCzechia 0.0574 USD
CICôte d’Ivoire 0.2955 USD
DKDenmark 0.0534 USD
DJDjibouti 0.1356 USD
DMDominica 0.2191 USD
DODominican Republic 0.1398 USD
ECEcuador 0.3025 USD
EGEgypt 0.3234 USD
SVEl Salvador 0.1321 USD
GQEquatorial Guinea 0.2086 USD
EREritrea 0.1077 USD
EEEstonia 0.0544 USD
SZEswatini 0.1773 USD
ETEthiopia 0.3187 USD
FKFalkland Islands 0.0758 USD
FOFaroe Islands 0.0554 USD
FJFiji 0.1956 USD
FIFinland 0.0487 USD
FRFrance 0.0573 USD
GFFrench Guiana 0.0621 USD
PFFrench Polynesia 0.0933 USD
GAGabon 0.3115 USD
GMGambia 0.1812 USD
GEGeorgia 0.1398 USD
DEGermany 0.1009 USD
GHGhana 0.2538 USD
GIGibraltar 0.0739 USD
GRGreece 0.0505 USD
GLGreenland 0.0131 USD
GDGrenada 0.2608 USD
GPGuadeloupe 0.1286 USD
GUGuam 0.1426 USD
GTGuatemala 0.2260 USD
GNGuinea 0.2782 USD
GWGuinea-Bissau 0.2573 USD
GYGuyana 0.2782 USD
HTHaiti 0.2826 USD
HNHonduras 0.1530 USD
HKHong Kong SAR China 0.0650 USD
HUHungary 0.0753 USD
ISIceland 0.0731 USD
INIndia 0.0863 USD
IDIndonesia 0.4671 USD
IRIran 0.3964 USD
IQIraq 0.3898 USD
IEIreland 0.0487 USD
ILIsrael 0.2318 USD
ITItaly 0.0554 USD
JMJamaica 0.1384 USD
JPJapan 0.0585 USD
JOJordan 0.3616 USD
KZKazakhstan 0.3912 USD
KEKenya 0.1391 USD
KIKiribati 0.0590 USD
XKKosovo 0.2898 USD
KWKuwait 0.3332 USD
KGKyrgyzstan 0.2977 USD
LALaos 0.1460 USD
LVLatvia 0.0580 USD
LBLebanon 0.0556 USD
LSLesotho 0.2747 USD
LRLiberia 0.2086 USD
LYLibya 0.3695 USD
LILiechtenstein 0.0462 USD
LTLithuania 0.0471 USD
LULuxembourg 0.1182 USD
MOMacao SAR China 0.0510 USD
MGMadagascar 0.4527 USD
MWMalawi 0.3042 USD
MYMalaysia 0.1739 USD
MVMaldives 0.0730 USD
MLMali 0.2469 USD
MTMalta 0.0635 USD
MHMarshall Islands 0.0653 USD
MQMartinique 0.0580 USD
MRMauritania 0.2643 USD
MUMauritius 0.1791 USD
MXMexico 0.0834 USD
FMMicronesia 0.0855 USD
MDMoldova 0.1545 USD
MCMonaco 0.1523 USD
MNMongolia 0.3405 USD
MEMontenegro 0.1667 USD
MSMontserrat 0.1460 USD
MAMorocco 0.0834 USD
MZMozambique 0.1460 USD
MMMyanmar (Burma) 0.4274 USD
NANamibia 0.0491 USD
NRNauru 0.1956 USD
NPNepal 0.2851 USD
NLNetherlands 0.0884 USD
NCNew Caledonia 0.1375 USD
NZNew Zealand 0.0487 USD
NINicaragua 0.1356 USD
NENiger 0.3260 USD
NGNigeria 0.3894 USD
NUNiue 0.1883 USD
KPNorth Korea 0.0972 USD
MKNorth Macedonia 0.1021 USD
NONorway 0.0417 USD
OMOman 0.2028 USD
PKPakistan 0.4172 USD
PWPalau 0.1327 USD
PSPalestinian Territories 0.3426 USD
PAPanama 0.1704 USD
PGPapua New Guinea 0.2246 USD
PYParaguay 0.0974 USD
PEPeru 0.1460 USD
PHPhilippines 0.2456 USD
PLPoland 0.0290 USD
PTPortugal 0.0305 USD
PRPuerto Rico 0.1211 USD
QAQatar 0.1217 USD
RORomania 0.0537 USD
RURussia 0.4680 USD
RWRwanda 0.3223 USD
RERéunion 0.0730 USD
WSSamoa 0.1634 USD
SMSan Marino 0.0649 USD
SASaudi Arabia 0.2225 USD
SNSenegal 0.2747 USD
RSSerbia 0.2260 USD
SCSeychelles 0.1252 USD
SLSierra Leone 0.2712 USD
SGSingapore 0.0534 USD
SXSint Maarten 0.1085 USD
SKSlovakia 0.0589 USD
SISlovenia 0.1812 USD
SBSolomon Islands 0.0974 USD
SOSomalia 0.2469 USD
ZASouth Africa 0.0556 USD
KRSouth Korea 0.0232 USD
SSSouth Sudan 0.3042 USD
ESSpain 0.0429 USD
LKSri Lanka 0.4339 USD
SHSt. Helena 0.1087 USD
KNSt. Kitts & Nevis 0.2826 USD
LCSt. Lucia 0.2747 USD
PMSt. Pierre & Miquelon 0.1391 USD
VCSt. Vincent & Grenadines 0.2191 USD
SDSudan 0.3550 USD
SRSuriname 0.2538 USD
SESweden 0.0562 USD
CHSwitzerland 0.0688 USD
SYSyria 0.3412 USD
STSão Tomé & Príncipe 0.0278 USD
TWTaiwan 0.0869 USD
TJTajikistan 0.4182 USD
TZTanzania 0.3115 USD
THThailand 0.0203 USD
TLTimor-Leste 0.1704 USD
TGTogo 0.2017 USD
TKTokelau 0.0290 USD
TOTonga 0.1956 USD
TTTrinidad & Tobago 0.2747 USD
TNTunisia 0.3338 USD
TMTurkmenistan 0.2536 USD
TCTurks & Caicos Islands 0.1847 USD
TVTuvalu 0.1812 USD
TRTürkiye 0.0088 USD
VIU.S. Virgin Islands 0.0428 USD
UGUganda 0.3274 USD
UAUkraine 0.2028 USD
AEUnited Arab Emirates 0.1058 USD
GBUnited Kingdom 0.0465 USD
USUnited States 0.0243 USD
ZZUnknown Region 0.0956 USD
UYUruguay 0.1232 USD
UZUzbekistan 0.4491 USD
VUVanuatu 0.1912 USD
VEVenezuela 0.1530 USD
VNVietnam 0.2572 USD
WFWallis & Futuna 0.0859 USD
YEYemen 0.1999 USD
ZMZambia 0.3035 USD
ZWZimbabwe 0.2108 USD