Sling API Documentation

Introduction

Sling API uses header authentication. Get your api token from your dashboard and fuse it to use the API. Kindly follow the documentation promptly.

Base URL
https://v2.sling.com.ng/api/v1
Headers:
Accept           application/json
Authorization    Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard

Send SMS

Send SMS URL
POST REQUEST
https://v2.sling.com.ng/api/v1/send-sms
Headers:
Accept           application/json
Content-type     application/x-www-form-urlencoded
Authorization    Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard

URL REQUEST
https://v2.sling.com.ng/api/v1/send-sms?api_token=$api_token&to=$phone&message=$message

Accepted Parameters

Parameter Description
to
Recipient Phone Number
11 Digit phone or with country code 234 without the +
message
Message to be sent
Max of 3 pages

On success 200 OK:
{
 "status": "success",
 "message_id": "2bajqzt5tw",
 "sender": "Sling",
 "message": "Hello, from Sling",
 "recipient": "2349123772222",
 "credit_used": 1
}

Error Samples 400 Bad Request:
Insufficient Credit
{
 "status": "fail",
 "credit_used": "0",
 "details": "insufficient credit"
}
Incomplete Parameters
{
 "status": "fail",
 "credit_used": "0",
 "details": "Incorrect Param"
}

Check SMS Status

Check SMS Status URL
GET REQUEST
https://v2.sling.com.ng/api/v1/status/{message_id}
Headers:
Accept           application/json
Content-type     application/x-www-form-urlencoded
Authorization    Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard
Replace {message_id} with the Message ID of your message

On success 200 OK:
{
  "status": "success",
  "message_id": "0btn9fbaeg",
  "credit_used": "1",
  "sender": "13290",
  "recipient": "2349123772222"
}

Error Samples 400 Bad Request:
Missing Message ID
{
 "status": "fail",
 "details": "Message ID is required"
}
Invalid Message ID
{
 "status": "fail",
 "details": "Invalid Message ID"
}

Available Credit

Available Credit URL
GET REQUEST
https://v2.sling.com.ng/api/v1/balance
Headers:
Accept           application/json
Content-type     application/x-www-form-urlencoded
Authorization    Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard

URL REQUEST
https://v2.sling.com.ng/api/v1/balance?api_token=$api_token

On success 200 OK:
{
 "status": "success",
 "balance": "339"
}

Fequently Asked Questions

How does your system work?

We use SenderID, Long Code and Shot Code to deliver Messsages

Can I send SMS using my phone number?

Yes you can. You will have to send us your SIM Card. Kindly contact us for more info

Can I get SMS at a cheaper rate?

We send SMS at a very low rate. But resellers and corporate entities will get a good discount!

Thank you!

Once again, thank you so choosing Sling. We appreciate it very much. We wish you all the best with your upcoming projects! Feel free to drop us a message on hello@sling.com.ng or via any of our social media accounts.

Have a great day and happy coding!