Recipient phone number (E.164 format, e.g., +919999999999)
variables
Array
Optional
List of values required by the template. Must match the template variable count.
If the template includes a dynamic URL button, pass its button valueafter the body variables in the same array.
media_file
File
Conditional
Required only when the template uses dynamic media.
Upload the media file corresponding to the template header type
(image, video, or document). For static media templates, this parameter is not required.
Response Parameters
Parameter
Type
Description
status
Boolean
Request status (true/false)
code
Numeric
API status code
data.message_id
String
Unique message identifier
message
String / Array
Error or success message
Response Codes
SPRL Code
HTTP Status
Mode
Response Field
Description
100
200
success
data
Request processed successfully.
101
401
failed
message
Authentication failed. Invalid or missing API credentials.
102
422
failed
errors
Parameter validation failed. Check the input fields.
103
403
failed
error
SPRL account is restricted (temporary or permanent block).
104
400
failed
errors
Insufficient wallet balance. Recharge required.
105
500
failed
message
Unexpected server error. Please try again later.
129
429
failed
errors
API usage limit exceeded (daily, monthly, or total).
Error Flag Reference
Category
Flag
Type
Description
Account
ACCOUNT_PERMANENT_BLOCKED
account_restricted
The SPRL account has been permanently blocked.
Account
ACCOUNT_TEMP_BLOCKED
account_restricted
The SPRL account has been temporarily restricted.
Billing
INSUFFICIENT_BALANCE
billing_error
The wallet balance is insufficient to process the request.
Rate Limit
DAILY_LIMIT_REACHED
rate_limit_exceeded
The daily API usage limit has been exceeded.
Rate Limit
MONTHLY_LIMIT_REACHED
rate_limit_exceeded
The monthly API usage limit has been exceeded.
Rate Limit
TOTAL_LIMIT_REACHED
rate_limit_exceeded
The total API usage limit has been exceeded.
Validation
INVALID_PARAMETER
validation_error
One or more request parameters are invalid.
Authentication
INVALID_CREDENTIALS
auth_error
API credentials are missing or invalid.
Server
UNEXPECTED_ERROR
server_error
An unexpected internal server error occurred.
99.9% Uptime
High Availability Infrastructure
Enterprise Security
OWASP-Aligned Controls
Built for Scale
High-Performance REST APIs
Security & Compliance
We follow industry best practices for API security and data protection.
Our APIs are designed with authentication, rate limiting, and continuous security review.
We use cookies to improve your experience, analyse traffic, and personalise content.
By clicking “Accept”, you consent to the use of cookies as described in our
Cookie Policy
.