Robo SMS API Documentation
Send transactional and promotional SMS, check balance and manage account usage programmatically.
All API requests require authentication using your API key. You can generate your API key from Robo SMS Dashboard after login.
View DashboardGetting Started
Welcome to Robo SMS Pakistan API documentation. Use our REST API to send transactional and promotional SMS, check balances, and manage delivery workflows programmatically.
Authentication
All API requests require your API key. Keep it private and pass it as api_key for GET examples or Bearer token for JSON POST requests.
Base URL
https://api.robosms.pk/v1
Send SMS Single
Send a single SMS to one mobile number. Parameters are passed as URL query parameters.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| api_key | string | Yes | Your API key from dashboard | YOUR_API_KEY |
| to / numbers | string | Yes | Recipient mobile number or comma separated numbers | 923001234567 |
| message | string | Yes | Message content | Your OTP is 123456 |
| from | string | No | Sender ID Mask or Short Code | YOURBRAND / XXXX |
| type | string | No | transactional or promotional | transactional |
| unicode | string | No | 0 for English, 1 for Unicode | 0 |
Send SMS Bulk
Send the same message to multiple numbers in one request.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| api_key | string | Yes | Your API key from dashboard | YOUR_API_KEY |
| to / numbers | string | Yes | Recipient mobile number or comma separated numbers | 923001234567 |
| message | string | Yes | Message content | Your OTP is 123456 |
| from | string | No | Sender ID Mask or Short Code | YOURBRAND / XXXX |
| type | string | No | transactional or promotional | transactional |
| unicode | string | No | 0 for English, 1 for Unicode | 0 |
Check SMS Balance
Check your available SMS balance from your account.
API Response Codes
200 Success, 400 Missing parameters, 401 Invalid API key, 402 Insufficient balance, 429 Rate limit exceeded, 500 Server error.
Security Best Practices
Do not expose your API key in frontend code. Use HTTPS for all requests, rotate keys when needed, and validate numbers before sending.
Short Code and Masking Notes
Short Code and Sender ID Masking use the same SMS API. Change the from value only. Sender ID Mask example: from=YOURBRAND. Short Code example: from=XXXX. Both require additional KYC and documentation for PTA compliance. Short Code is a separate package and MRC monthly recurring charges apply.
Short Code (Pre-Approved)
Use from=XXXX with the same SMS API. Short Code has a separate package and MRC monthly recurring charges apply.
Sender ID Masking (Same API)
Use from=YOURBRAND with the same SMS API. Additional KYC and documentation are required for PTA compliance.
For Short Code and Sender ID Masking service, additional KYC and documentation is required as per PTA regulations. Our team will guide you through the complete compliance process.