SenderIL API Documentation

Important: All endpoints require POST method with Content-Type: application/json header.

1. Check Balance

POST /api/balance
fetch('https://senderil.com/api/balance', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        api_key: 'YOUR_API_KEY'
    })
})
.then(res => res.json())
.then(data => console.log(data))

Response:

{ "credits": 1000, "sender_name": "MyBrand" }

2. Send Single SMS

POST /api/send_sms
ParameterTypeRequiredDescription
api_keystringYesYour API key
tostringYesPhone number (972...)
messagestringYesSMS text
senderstringNoSender name (max 11 chars)
fetch('https://senderil.com/api/send_sms', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        api_key: 'YOUR_API_KEY',
        to: '972541234567',
        message: 'Hello!',
        sender: 'MyBrand'
    })
})
.then(res => res.json())
.then(data => console.log(data))

Response:

{ "success": true, "message": "Sent", "sender_used": "MyBrand" }

3. Send Bulk SMS (up to 1000)

POST /api/send_bulk
ParameterTypeRequiredDescription
api_keystringYesYour API key
numbersarrayYesArray of phone numbers
messagestringYesSMS text
senderstringNoSender name (max 11 chars)
fetch('https://senderil.com/api/send_bulk', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        api_key: 'YOUR_API_KEY',
        numbers: ['972541234567', '972521234567'],
        message: 'Hello from SenderIL!',
        sender: 'MyBrand'
    })
})
.then(res => res.json())
.then(data => console.log(data))

Response:

{ "success": true, "sent": 2, "sender": "MyBrand", "credits_remaining": 998 }

Error Codes

CodeMeaning
400Missing parameters
401Invalid API key
402Not enough credits
405Wrong method (use POST, not GET)
500Server error
Note: Phone numbers must be in international format starting with 972 (no leading zero). Example: 972541234567