Developers

# 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"
# }