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.4921 PLN
ALAlbania 0.4778 PLN
DZAlgeria 1.2152 PLN
ASAmerican Samoa 0.5099 PLN
ADAndorra 0.3615 PLN
AOAngola 0.3385 PLN
AIAnguilla 0.7031 PLN
AGAntigua & Barbuda 0.9635 PLN
ARArgentina 0.3932 PLN
AMArmenia 0.9222 PLN
AWAruba 0.5729 PLN
AUAustralia 0.1315 PLN
ATAustria 0.2257 PLN
AZAzerbaijan 1.3489 PLN
BSBahamas 0.3173 PLN
BHBahrain 0.1823 PLN
BDBangladesh 1.9938 PLN
BBBarbados 1.0581 PLN
BYBelarus 0.7651 PLN
BEBelgium 0.3515 PLN
BZBelize 0.9032 PLN
BJBenin 0.9630 PLN
BMBermuda 1.0581 PLN
BTBhutan 1.3563 PLN
BOBolivia 0.8984 PLN
BABosnia & Herzegovina 0.6119 PLN
BWBotswana 0.5698 PLN
BRBrazil 0.1089 PLN
IOBritish Indian Ocean Territory 0.4948 PLN
VGBritish Virgin Islands 1.0581 PLN
BNBrunei 0.2443 PLN
BGBulgaria 0.5968 PLN
BFBurkina Faso 0.7942 PLN
BIBurundi 1.7186 PLN
KHCambodia 1.3020 PLN
CMCameroon 1.0676 PLN
CACanada 0.0911 PLN
CVCape Verde 0.8272 PLN
KYCayman Islands 0.9765 PLN
CFCentral African Republic 0.3776 PLN
TDChad 1.2612 PLN
CLChile 0.1775 PLN
CNChina 0.1033 PLN
COColombia 0.0816 PLN
KMComoros 1.3801 PLN
CGCongo - Brazzaville 0.8463 PLN
CDCongo - Kinshasa 1.1978 PLN
CKCook Islands 0.4917 PLN
CRCosta Rica 0.1194 PLN
HRCroatia 0.5620 PLN
CUCuba 0.3554 PLN
ANCuraçao 0.5208 PLN
CWCuraçao 1.1935 PLN
CYCyprus 0.4205 PLN
CZCzechia 0.2148 PLN
CICôte d’Ivoire 1.1067 PLN
DKDenmark 0.2001 PLN
DJDjibouti 0.5078 PLN
DMDominica 0.8203 PLN
DODominican Republic 0.5234 PLN
ECEcuador 1.1327 PLN
EGEgypt 1.2109 PLN
SVEl Salvador 0.4948 PLN
GQEquatorial Guinea 0.7812 PLN
EREritrea 0.4032 PLN
EEEstonia 0.2035 PLN
SZEswatini 0.6640 PLN
ETEthiopia 1.1935 PLN
FKFalkland Islands 0.2838 PLN
FOFaroe Islands 0.2075 PLN
FJFiji 0.7326 PLN
FIFinland 0.1823 PLN
FRFrance 0.2144 PLN
GFFrench Guiana 0.2326 PLN
PFFrench Polynesia 0.3494 PLN
GAGabon 1.1666 PLN
GMGambia 0.6783 PLN
GEGeorgia 0.5234 PLN
DEGermany 0.3780 PLN
GHGhana 0.9505 PLN
GIGibraltar 0.2769 PLN
GRGreece 0.1892 PLN
GLGreenland 0.0490 PLN
GDGrenada 0.9765 PLN
GPGuadeloupe 0.4817 PLN
GUGuam 0.5338 PLN
GTGuatemala 0.8463 PLN
GNGuinea 1.0416 PLN
GWGuinea-Bissau 0.9635 PLN
GYGuyana 1.0416 PLN
HTHaiti 1.0581 PLN
HNHonduras 0.5729 PLN
HKHong Kong SAR China 0.2435 PLN
HUHungary 0.2821 PLN
ISIceland 0.2739 PLN
INIndia 0.3233 PLN
IDIndonesia 1.7490 PLN
IRIran 1.4843 PLN
IQIraq 1.4595 PLN
IEIreland 0.1823 PLN
ILIsrael 0.8680 PLN
ITItaly 0.2075 PLN
JMJamaica 0.5182 PLN
JPJapan 0.2192 PLN
JOJordan 1.3541 PLN
KZKazakhstan 1.4648 PLN
KEKenya 0.5208 PLN
KIKiribati 0.2209 PLN
XKKosovo 1.0850 PLN
KWKuwait 1.2478 PLN
KGKyrgyzstan 1.1149 PLN
LALaos 0.5468 PLN
LVLatvia 0.2170 PLN
LBLebanon 0.2083 PLN
LSLesotho 1.0286 PLN
LRLiberia 0.7812 PLN
LYLibya 1.3836 PLN
LILiechtenstein 0.1732 PLN
LTLithuania 0.1762 PLN
LULuxembourg 0.4427 PLN
MOMacao SAR China 0.1910 PLN
MGMadagascar 1.6952 PLN
MWMalawi 1.1393 PLN
MYMalaysia 0.6510 PLN
MVMaldives 0.2734 PLN
MLMali 0.9244 PLN
MTMalta 0.2378 PLN
MHMarshall Islands 0.2443 PLN
MQMartinique 0.2170 PLN
MRMauritania 0.9895 PLN
MUMauritius 0.6705 PLN
MXMexico 0.3125 PLN
FMMicronesia 0.3203 PLN
MDMoldova 0.5785 PLN
MCMonaco 0.5703 PLN
MNMongolia 1.2751 PLN
MEMontenegro 0.6241 PLN
MSMontserrat 0.5468 PLN
MAMorocco 0.3125 PLN
MZMozambique 0.5468 PLN
MMMyanmar (Burma) 1.6006 PLN
NANamibia 0.1840 PLN
NRNauru 0.7326 PLN
NPNepal 1.0676 PLN
NLNetherlands 0.3311 PLN
NCNew Caledonia 0.5147 PLN
NZNew Zealand 0.1823 PLN
NINicaragua 0.5078 PLN
NENiger 1.2208 PLN
NGNigeria 1.4582 PLN
NUNiue 0.7053 PLN
KPNorth Korea 0.3641 PLN
MKNorth Macedonia 0.3824 PLN
NONorway 0.1562 PLN
OMOman 0.7595 PLN
PKPakistan 1.5624 PLN
PWPalau 0.4969 PLN
PSPalestinian Territories 1.2829 PLN
PAPanama 0.6380 PLN
PGPapua New Guinea 0.8411 PLN
PYParaguay 0.3646 PLN
PEPeru 0.5468 PLN
PHPhilippines 0.9196 PLN
PLPoland 0.1085 PLN
PTPortugal 0.1141 PLN
PRPuerto Rico 0.4535 PLN
QAQatar 0.4557 PLN
RORomania 0.2009 PLN
RURussia 1.7525 PLN
RWRwanda 1.2070 PLN
RERéunion 0.2734 PLN
WSSamoa 0.6119 PLN
SMSan Marino 0.2430 PLN
SASaudi Arabia 0.8333 PLN
SNSenegal 1.0286 PLN
RSSerbia 0.8463 PLN
SCSeychelles 0.4687 PLN
SLSierra Leone 1.0156 PLN
SGSingapore 0.2001 PLN
SXSint Maarten 0.4062 PLN
SKSlovakia 0.2205 PLN
SISlovenia 0.6783 PLN
SBSolomon Islands 0.3646 PLN
SOSomalia 0.9244 PLN
ZASouth Africa 0.2083 PLN
KRSouth Korea 0.0868 PLN
SSSouth Sudan 1.1393 PLN
ESSpain 0.1606 PLN
LKSri Lanka 1.6249 PLN
SHSt. Helena 0.4071 PLN
KNSt. Kitts & Nevis 1.0581 PLN
LCSt. Lucia 1.0286 PLN
PMSt. Pierre & Miquelon 0.5208 PLN
VCSt. Vincent & Grenadines 0.8203 PLN
SDSudan 1.3293 PLN
SRSuriname 0.9505 PLN
SESweden 0.2105 PLN
CHSwitzerland 0.2578 PLN
SYSyria 1.2777 PLN
STSão Tomé & Príncipe 0.1042 PLN
TWTaiwan 0.3255 PLN
TJTajikistan 1.5659 PLN
TZTanzania 1.1666 PLN
THThailand 0.0760 PLN
TLTimor-Leste 0.6380 PLN
TGTogo 0.7552 PLN
TKTokelau 0.1085 PLN
TOTonga 0.7326 PLN
TTTrinidad & Tobago 1.0286 PLN
TNTunisia 1.2499 PLN
TMTurkmenistan 0.9496 PLN
TCTurks & Caicos Islands 0.6918 PLN
TVTuvalu 0.6783 PLN
TRTürkiye 0.0330 PLN
VIU.S. Virgin Islands 0.1601 PLN
UGUganda 1.2260 PLN
UAUkraine 0.7595 PLN
AEUnited Arab Emirates 0.3962 PLN
GBUnited Kingdom 0.1740 PLN
USUnited States 0.0911 PLN
ZZUnknown Region 0.3581 PLN
UYUruguay 0.4613 PLN
UZUzbekistan 1.6818 PLN
VUVanuatu 0.7161 PLN
VEVenezuela 0.5729 PLN
VNVietnam 0.9630 PLN
WFWallis & Futuna 0.3216 PLN
YEYemen 0.7486 PLN
ZMZambia 1.1366 PLN
ZWZimbabwe 0.7894 PLN