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 3.8815 SEK
ALAlbania 1.2430 SEK
DZAlgeria 3.1612 SEK
ASAmerican Samoa 1.3266 SEK
ADAndorra 0.9405 SEK
AOAngola 0.8806 SEK
AIAnguilla 1.8290 SEK
AGAntigua & Barbuda 2.5064 SEK
ARArgentina 1.0229 SEK
AMArmenia 2.3991 SEK
AWAruba 1.4903 SEK
AUAustralia 0.3421 SEK
ATAustria 0.5871 SEK
AZAzerbaijan 3.5089 SEK
BSBahamas 0.8253 SEK
BHBahrain 0.4742 SEK
BDBangladesh 5.1866 SEK
BBBarbados 2.7525 SEK
BYBelarus 1.9904 SEK
BEBelgium 0.9145 SEK
BZBelize 2.3494 SEK
BJBenin 2.5053 SEK
BMBermuda 2.7525 SEK
BTBhutan 3.5281 SEK
BOBolivia 2.3370 SEK
BABosnia & Herzegovina 1.5919 SEK
BWBotswana 1.4824 SEK
BRBrazil 0.2834 SEK
IOBritish Indian Ocean Territory 1.2871 SEK
VGBritish Virgin Islands 2.7525 SEK
BNBrunei 0.6356 SEK
BGBulgaria 1.5524 SEK
BFBurkina Faso 2.0661 SEK
BIBurundi 4.4708 SEK
KHCambodia 3.3870 SEK
CMCameroon 2.7773 SEK
CACanada 0.2371 SEK
CVCape Verde 2.1519 SEK
KYCayman Islands 2.5403 SEK
CFCentral African Republic 0.9822 SEK
TDChad 3.2809 SEK
CLChile 0.4618 SEK
CNChina 0.2687 SEK
COColombia 0.2123 SEK
KMComoros 3.5902 SEK
CGCongo - Brazzaville 2.2016 SEK
CDCongo - Kinshasa 3.1160 SEK
CKCook Islands 1.2792 SEK
CRCosta Rica 0.3105 SEK
HRCroatia 1.4621 SEK
CUCuba 0.9247 SEK
ANCuraçao 1.3548 SEK
CWCuraçao 3.1048 SEK
CYCyprus 1.0940 SEK
CZCzechia 0.5589 SEK
CICôte d’Ivoire 2.8789 SEK
DKDenmark 0.5205 SEK
DJDjibouti 1.3209 SEK
DMDominica 2.1338 SEK
DODominican Republic 1.3616 SEK
ECEcuador 2.9467 SEK
EGEgypt 3.1499 SEK
SVEl Salvador 1.2871 SEK
GQEquatorial Guinea 2.0322 SEK
EREritrea 1.0488 SEK
EEEstonia 0.5295 SEK
SZEswatini 1.7274 SEK
ETEthiopia 3.1048 SEK
FKFalkland Islands 0.7384 SEK
FOFaroe Islands 0.5397 SEK
FJFiji 1.9058 SEK
FIFinland 0.4742 SEK
FRFrance 0.5577 SEK
GFFrench Guiana 0.6051 SEK
PFFrench Polynesia 0.9088 SEK
GAGabon 3.0348 SEK
GMGambia 1.7646 SEK
GEGeorgia 1.3616 SEK
DEGermany 0.9834 SEK
GHGhana 2.4725 SEK
GIGibraltar 0.7203 SEK
GRGreece 0.4922 SEK
GLGreenland 0.1276 SEK
GDGrenada 2.5403 SEK
GPGuadeloupe 1.2532 SEK
GUGuam 1.3887 SEK
GTGuatemala 2.2016 SEK
GNGuinea 2.7096 SEK
GWGuinea-Bissau 2.5064 SEK
GYGuyana 2.7096 SEK
HTHaiti 2.7525 SEK
HNHonduras 1.4903 SEK
HKHong Kong SAR China 0.6334 SEK
HUHungary 0.7339 SEK
ISIceland 0.7124 SEK
INIndia 0.8411 SEK
IDIndonesia 4.5499 SEK
IRIran 3.8612 SEK
IQIraq 3.7968 SEK
IEIreland 0.4742 SEK
ILIsrael 2.2580 SEK
ITItaly 0.5397 SEK
JMJamaica 1.3480 SEK
JPJapan 0.5701 SEK
JOJordan 3.5225 SEK
KZKazakhstan 3.8104 SEK
KEKenya 1.3548 SEK
KIKiribati 0.5747 SEK
XKKosovo 2.8225 SEK
KWKuwait 3.2459 SEK
KGKyrgyzstan 2.9004 SEK
LALaos 1.4225 SEK
LVLatvia 0.5645 SEK
LBLebanon 0.5419 SEK
LSLesotho 2.6757 SEK
LRLiberia 2.0322 SEK
LYLibya 3.5993 SEK
LILiechtenstein 0.4505 SEK
LTLithuania 0.4584 SEK
LULuxembourg 1.1516 SEK
MOMacao SAR China 0.4968 SEK
MGMadagascar 4.4099 SEK
MWMalawi 2.9636 SEK
MYMalaysia 1.6935 SEK
MVMaldives 0.7113 SEK
MLMali 2.4048 SEK
MTMalta 0.6187 SEK
MHMarshall Islands 0.6356 SEK
MQMartinique 0.5645 SEK
MRMauritania 2.5741 SEK
MUMauritius 1.7443 SEK
MXMexico 0.8129 SEK
FMMicronesia 0.8332 SEK
MDMoldova 1.5050 SEK
MCMonaco 1.4835 SEK
MNMongolia 3.3170 SEK
MEMontenegro 1.6235 SEK
MSMontserrat 1.4225 SEK
MAMorocco 0.8129 SEK
MZMozambique 1.4225 SEK
MMMyanmar (Burma) 4.1638 SEK
NANamibia 0.4787 SEK
NRNauru 1.9058 SEK
NPNepal 2.7773 SEK
NLNetherlands 0.8614 SEK
NCNew Caledonia 1.3390 SEK
NZNew Zealand 0.4742 SEK
NINicaragua 1.3209 SEK
NENiger 3.1759 SEK
NGNigeria 3.7934 SEK
NUNiue 1.8346 SEK
KPNorth Korea 0.9472 SEK
MKNorth Macedonia 0.9946 SEK
NONorway 0.4064 SEK
OMOman 1.9757 SEK
PKPakistan 4.0644 SEK
PWPalau 1.2927 SEK
PSPalestinian Territories 3.3373 SEK
PAPanama 1.6596 SEK
PGPapua New Guinea 2.1880 SEK
PYParaguay 0.9484 SEK
PEPeru 1.4225 SEK
PHPhilippines 2.3924 SEK
PLPoland 0.2823 SEK
PTPortugal 0.2969 SEK
PRPuerto Rico 1.1798 SEK
QAQatar 1.1855 SEK
RORomania 0.5227 SEK
RURussia 4.5589 SEK
RWRwanda 3.1397 SEK
RERéunion 0.7113 SEK
WSSamoa 1.5919 SEK
SMSan Marino 0.6322 SEK
SASaudi Arabia 2.1677 SEK
SNSenegal 2.6757 SEK
RSSerbia 2.2016 SEK
SCSeychelles 1.2193 SEK
SLSierra Leone 2.6419 SEK
SGSingapore 0.5205 SEK
SXSint Maarten 1.0567 SEK
SKSlovakia 0.5735 SEK
SISlovenia 1.7646 SEK
SBSolomon Islands 0.9484 SEK
SOSomalia 2.4048 SEK
ZASouth Africa 0.5419 SEK
KRSouth Korea 0.2258 SEK
SSSouth Sudan 2.9636 SEK
ESSpain 0.4177 SEK
LKSri Lanka 4.2270 SEK
SHSt. Helena 1.0590 SEK
KNSt. Kitts & Nevis 2.7525 SEK
LCSt. Lucia 2.6757 SEK
PMSt. Pierre & Miquelon 1.3548 SEK
VCSt. Vincent & Grenadines 2.1338 SEK
SDSudan 3.4581 SEK
SRSuriname 2.4725 SEK
SESweden 0.5476 SEK
CHSwitzerland 0.6706 SEK
SYSyria 3.3238 SEK
STSão Tomé & Príncipe 0.2710 SEK
TWTaiwan 0.8467 SEK
TJTajikistan 4.0734 SEK
TZTanzania 3.0348 SEK
THThailand 0.1976 SEK
TLTimor-Leste 1.6596 SEK
TGTogo 1.9645 SEK
TKTokelau 0.2823 SEK
TOTonga 1.9058 SEK
TTTrinidad & Tobago 2.6757 SEK
TNTunisia 3.2515 SEK
TMTurkmenistan 2.4703 SEK
TCTurks & Caicos Islands 1.7996 SEK
TVTuvalu 1.7646 SEK
TRTürkiye 0.0858 SEK
VIU.S. Virgin Islands 0.4166 SEK
UGUganda 3.1894 SEK
UAUkraine 1.9757 SEK
AEUnited Arab Emirates 1.0308 SEK
GBUnited Kingdom 0.4527 SEK
USUnited States 0.2371 SEK
ZZUnknown Region 0.9314 SEK
UYUruguay 1.2001 SEK
UZUzbekistan 4.3749 SEK
VUVanuatu 1.8629 SEK
VEVenezuela 1.4903 SEK
VNVietnam 2.5053 SEK
WFWallis & Futuna 0.8366 SEK
YEYemen 1.9475 SEK
ZMZambia 2.9569 SEK
ZWZimbabwe 2.0537 SEK