API Documentation

Integrate our bulk SMS platform with your applications using our REST API.

Base URL: http://speedboltsms.top/api/index.php

Authentication

All API requests require an API key passed in the X-API-Key header.

curl -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  http://speedboltsms.top/api/index.php?endpoint=balance

Endpoints

GET balance ?endpoint=balance

Get your wallet balance and SMS credits.

{
  "status": "success",
  "data": {
    "balance": "150.00",
    "sms_credits": "5000"
  }
}
POST send_sms ?endpoint=send_sms

Send SMS to one or more recipients.

{
  "sender": "MyCompany",
  "message": "Hello, this is a test message",
  "recipients": ["0241234567", "0201234567"]
}
GET campaigns ?endpoint=campaigns

List your recent campaigns.

GET campaign ?endpoint=campaign&id=123

Get details of a specific campaign.

GET pricing ?endpoint=pricing

Get available SMS bundles and pricing.

POST contacts ?endpoint=contacts

Add a new contact.

{
  "phone": "0241234567",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com"
}

Rate Limits

API requests are limited to 100 requests per minute per API key.

Error Codes

CodeDescription
200Success
400Bad Request - Missing or invalid parameters
401Unauthorized - Invalid or missing API key
403Forbidden - Account inactive or API disabled
404Not Found - Resource or endpoint not found
405Method Not Allowed
429Too Many Requests - Rate limit exceeded