# Reliable SMS API Services in Sri Lanka — VeloBotix Developer Hub

> VeloBotix provides reliable SMS API services in Sri Lanka over local operator routes. REST API with Basic Auth — PHP, Node.js, Python, Java, Laravel examples. Free LKR 50 trial.

Source: https://www.velobotix.app/developers

# Developers

Integrate the Sri Lanka SMS gateway with HTTP Basic Auth. No OAuth. Portal issues the API key.

-   [API documentation](https://www.velobotix.app/docs)
-   [Getting started](https://www.velobotix.app/docs/getting-started)
-   [SMS API overview](https://www.velobotix.app/sms-api-sri-lanka)
-   [PHP](https://www.velobotix.app/docs/php)
-   [Node.js](https://www.velobotix.app/docs/nodejs)
-   [Python](https://www.velobotix.app/docs/python)
-   [Laravel](https://www.velobotix.app/docs/laravel)
-   [Platform integrations](https://www.velobotix.app/integrations)

Developer-First API

## SMS REST API for Sri Lanka — live in minutes

A clean REST API with both GET and POST support. Authenticate with your email and API key — no OAuth setup, no SDK required. Just plain HTTP requests.

Authentication — Basic Auth

Username your-email@domain.com

Password YOUR\_API\_KEY

-   GET & POST endpoints — use whichever suits your stack
-   Single SMS with custom Sender ID
-   Bulk Same — up to 10,000 numbers per request
-   Bulk Different — up to 20 personalised messages
-   Optional cost preview before bulk send
-   Real-time account balance check
-   Sri Lanka local format (07XXXXXXXX) supported

[Get Your API Key](https://portal.velobotix.app)[View Plans](https://www.velobotix.app/sms-pricing-sri-lanka)

BASE URL: https://portal.velobotix.app/

```
# Send a single SMS via GET request
# All parameters passed in the query string

curl "https://portal.velobotix.app/api.php \
  ?FUN=SEND_SINGLE \
  &with_get=true \
  &un=YOUR_EMAIL \
  &up=YOUR_API_KEY \
  &senderID=VeloBotix \
  &to=0701234567 \
  &msg=Your+OTP+is+483920.+Valid+5+mins."
```

```
# Send a single SMS via POST (JSON body)
# Use Basic Auth: email + API key

curl -X POST \
  "https://portal.velobotix.app/api.php?FUN=SEND_SINGLE" \
  -u "YOUR_EMAIL:YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID": "VeloBotix",
    "to":       "0701234567",
    "msg":      "Your OTP is 483920. Valid for 5 minutes."
  }'
```

```
# Send the SAME message to multiple recipients
# Up to 10,000 numbers per request
# Add "check_cost": true to preview cost first

curl -X POST \
  "https://portal.velobotix.app/api.php?FUN=SEND_BULK_SAME" \
  -u "YOUR_EMAIL:YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID":   "VeloBotix",
    "to":         ["0701234567", "0712345678", "0723456789"],
    "msg":        "Flash Sale! 50% off sitewide today only.",
    "check_cost": true
  }'
```

```
# Send DIFFERENT personalised messages per recipient
# Up to 20 unique messages per request

curl -X POST \
  "https://portal.velobotix.app/api.php?FUN=SEND_BULK_DIFFERENT" \
  -u "YOUR_EMAIL:YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID": "VeloBotix",
    "msg_list": [
      { "to": "0701234567", "msg": "Hi Amal! Order #1234 has shipped." },
      { "to": "0712345678", "msg": "Hi Nimal! Order #1235 is ready." },
      { "to": "0723456789", "msg": "Hi Kamal! Your invoice is due." }
    ]
  }'
```

```
# Check your account balance at any time

curl -X POST \
  "https://portal.velobotix.app/api.php?FUN=CHECK_BALANCE" \
  -u "YOUR_EMAIL:YOUR_API_KEY"

# Response:
# {
#   "balance": "LKR 2,450.00",
#   "status":  "active"
# }
```

200 OK · { "status": "success", "message\_id": "msg\_a1b2c3" }

### Query Parameters — GET Single

All parameters passed in the URL when using `with_get=true`

Parameter

Value

Description

FUN

SEND\_SINGLE

Function name — specifies the action

with\_get

true

Required — enables GET query string mode

un

your@email.com

Your account email address

up

YOUR\_API\_KEY

Your account API key (password)

senderID

VeloBotix

Approved Sender ID for your account

to

0701234567

Recipient's phone number (Sri Lanka format)

msg or text

Your message here

The SMS body content