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 48.0000 ISK
ALAlbania 16.0000 ISK
DZAlgeria 39.0000 ISK
ASAmerican Samoa 17.0000 ISK
ADAndorra 12.0000 ISK
AOAngola 11.0000 ISK
AIAnguilla 23.0000 ISK
AGAntigua & Barbuda 31.0000 ISK
ARArgentina 13.0000 ISK
AMArmenia 30.0000 ISK
AWAruba 19.0000 ISK
AUAustralia 4.0000 ISK
ATAustria 7.0000 ISK
AZAzerbaijan 44.0000 ISK
BSBahamas 10.0000 ISK
BHBahrain 6.0000 ISK
BDBangladesh 65.0000 ISK
BBBarbados 34.0000 ISK
BYBelarus 25.0000 ISK
BEBelgium 11.0000 ISK
BZBelize 29.0000 ISK
BJBenin 31.0000 ISK
BMBermuda 34.0000 ISK
BTBhutan 44.0000 ISK
BOBolivia 29.0000 ISK
BABosnia & Herzegovina 20.0000 ISK
BWBotswana 18.0000 ISK
BRBrazil 4.0000 ISK
IOBritish Indian Ocean Territory 16.0000 ISK
VGBritish Virgin Islands 34.0000 ISK
BNBrunei 8.0000 ISK
BGBulgaria 19.0000 ISK
BFBurkina Faso 26.0000 ISK
BIBurundi 56.0000 ISK
KHCambodia 42.0000 ISK
CMCameroon 35.0000 ISK
CACanada 3.0000 ISK
CVCape Verde 27.0000 ISK
KYCayman Islands 32.0000 ISK
CFCentral African Republic 12.0000 ISK
TDChad 41.0000 ISK
CLChile 6.0000 ISK
CNChina 3.0000 ISK
COColombia 3.0000 ISK
KMComoros 45.0000 ISK
CGCongo - Brazzaville 27.0000 ISK
CDCongo - Kinshasa 39.0000 ISK
CKCook Islands 16.0000 ISK
CRCosta Rica 4.0000 ISK
HRCroatia 18.0000 ISK
CUCuba 12.0000 ISK
ANCuraçao 17.0000 ISK
CWCuraçao 39.0000 ISK
CYCyprus 14.0000 ISK
CZCzechia 7.0000 ISK
CICôte d’Ivoire 36.0000 ISK
DKDenmark 6.0000 ISK
DJDjibouti 16.0000 ISK
DMDominica 27.0000 ISK
DODominican Republic 17.0000 ISK
ECEcuador 37.0000 ISK
EGEgypt 39.0000 ISK
SVEl Salvador 16.0000 ISK
GQEquatorial Guinea 25.0000 ISK
EREritrea 13.0000 ISK
EEEstonia 7.0000 ISK
SZEswatini 22.0000 ISK
ETEthiopia 39.0000 ISK
FKFalkland Islands 9.0000 ISK
FOFaroe Islands 7.0000 ISK
FJFiji 24.0000 ISK
FIFinland 6.0000 ISK
FRFrance 7.0000 ISK
GFFrench Guiana 8.0000 ISK
PFFrench Polynesia 11.0000 ISK
GAGabon 38.0000 ISK
GMGambia 22.0000 ISK
GEGeorgia 17.0000 ISK
DEGermany 12.0000 ISK
GHGhana 31.0000 ISK
GIGibraltar 9.0000 ISK
GRGreece 6.0000 ISK
GLGreenland 2.0000 ISK
GDGrenada 32.0000 ISK
GPGuadeloupe 16.0000 ISK
GUGuam 17.0000 ISK
GTGuatemala 27.0000 ISK
GNGuinea 34.0000 ISK
GWGuinea-Bissau 31.0000 ISK
GYGuyana 34.0000 ISK
HTHaiti 34.0000 ISK
HNHonduras 19.0000 ISK
HKHong Kong SAR China 8.0000 ISK
HUHungary 9.0000 ISK
ISIceland 9.0000 ISK
INIndia 10.0000 ISK
IDIndonesia 57.0000 ISK
IRIran 48.0000 ISK
IQIraq 47.0000 ISK
IEIreland 6.0000 ISK
ILIsrael 28.0000 ISK
ITItaly 7.0000 ISK
JMJamaica 17.0000 ISK
JPJapan 7.0000 ISK
JOJordan 44.0000 ISK
KZKazakhstan 48.0000 ISK
KEKenya 17.0000 ISK
KIKiribati 7.0000 ISK
XKKosovo 35.0000 ISK
KWKuwait 40.0000 ISK
KGKyrgyzstan 36.0000 ISK
LALaos 18.0000 ISK
LVLatvia 7.0000 ISK
LBLebanon 7.0000 ISK
LSLesotho 33.0000 ISK
LRLiberia 25.0000 ISK
LYLibya 45.0000 ISK
LILiechtenstein 6.0000 ISK
LTLithuania 6.0000 ISK
LULuxembourg 14.0000 ISK
MOMacao SAR China 6.0000 ISK
MGMadagascar 55.0000 ISK
MWMalawi 37.0000 ISK
MYMalaysia 21.0000 ISK
MVMaldives 9.0000 ISK
MLMali 30.0000 ISK
MTMalta 8.0000 ISK
MHMarshall Islands 8.0000 ISK
MQMartinique 7.0000 ISK
MRMauritania 32.0000 ISK
MUMauritius 22.0000 ISK
MXMexico 10.0000 ISK
FMMicronesia 10.0000 ISK
MDMoldova 19.0000 ISK
MCMonaco 19.0000 ISK
MNMongolia 41.0000 ISK
MEMontenegro 20.0000 ISK
MSMontserrat 18.0000 ISK
MAMorocco 10.0000 ISK
MZMozambique 18.0000 ISK
MMMyanmar (Burma) 52.0000 ISK
NANamibia 6.0000 ISK
NRNauru 24.0000 ISK
NPNepal 35.0000 ISK
NLNetherlands 11.0000 ISK
NCNew Caledonia 17.0000 ISK
NZNew Zealand 6.0000 ISK
NINicaragua 16.0000 ISK
NENiger 40.0000 ISK
NGNigeria 47.0000 ISK
NUNiue 23.0000 ISK
KPNorth Korea 12.0000 ISK
MKNorth Macedonia 12.0000 ISK
NONorway 5.0000 ISK
OMOman 25.0000 ISK
PKPakistan 51.0000 ISK
PWPalau 16.0000 ISK
PSPalestinian Territories 42.0000 ISK
PAPanama 21.0000 ISK
PGPapua New Guinea 27.0000 ISK
PYParaguay 12.0000 ISK
PEPeru 18.0000 ISK
PHPhilippines 30.0000 ISK
PLPoland 4.0000 ISK
PTPortugal 4.0000 ISK
PRPuerto Rico 15.0000 ISK
QAQatar 15.0000 ISK
RORomania 7.0000 ISK
RURussia 57.0000 ISK
RWRwanda 39.0000 ISK
RERéunion 9.0000 ISK
WSSamoa 20.0000 ISK
SMSan Marino 8.0000 ISK
SASaudi Arabia 27.0000 ISK
SNSenegal 33.0000 ISK
RSSerbia 27.0000 ISK
SCSeychelles 15.0000 ISK
SLSierra Leone 33.0000 ISK
SGSingapore 6.0000 ISK
SXSint Maarten 13.0000 ISK
SKSlovakia 7.0000 ISK
SISlovenia 22.0000 ISK
SBSolomon Islands 12.0000 ISK
SOSomalia 30.0000 ISK
ZASouth Africa 7.0000 ISK
KRSouth Korea 3.0000 ISK
SSSouth Sudan 37.0000 ISK
ESSpain 5.0000 ISK
LKSri Lanka 53.0000 ISK
SHSt. Helena 13.0000 ISK
KNSt. Kitts & Nevis 34.0000 ISK
LCSt. Lucia 33.0000 ISK
PMSt. Pierre & Miquelon 17.0000 ISK
VCSt. Vincent & Grenadines 27.0000 ISK
SDSudan 43.0000 ISK
SRSuriname 31.0000 ISK
SESweden 7.0000 ISK
CHSwitzerland 8.0000 ISK
SYSyria 41.0000 ISK
STSão Tomé & Príncipe 3.0000 ISK
TWTaiwan 11.0000 ISK
TJTajikistan 51.0000 ISK
TZTanzania 38.0000 ISK
THThailand 2.0000 ISK
TLTimor-Leste 21.0000 ISK
TGTogo 24.0000 ISK
TKTokelau 4.0000 ISK
TOTonga 24.0000 ISK
TTTrinidad & Tobago 33.0000 ISK
TNTunisia 41.0000 ISK
TMTurkmenistan 31.0000 ISK
TCTurks & Caicos Islands 22.0000 ISK
TVTuvalu 22.0000 ISK
TRTürkiye 1.0000 ISK
VIU.S. Virgin Islands 5.0000 ISK
UGUganda 40.0000 ISK
UAUkraine 25.0000 ISK
AEUnited Arab Emirates 13.0000 ISK
GBUnited Kingdom 6.0000 ISK
USUnited States 3.0000 ISK
ZZUnknown Region 12.0000 ISK
UYUruguay 15.0000 ISK
UZUzbekistan 55.0000 ISK
VUVanuatu 23.0000 ISK
VEVenezuela 19.0000 ISK
VNVietnam 31.0000 ISK
WFWallis & Futuna 10.0000 ISK
YEYemen 24.0000 ISK
ZMZambia 37.0000 ISK
ZWZimbabwe 26.0000 ISK