Quick Start

Get started with the JQuickNet SMS API in minutes

The JQuickNet API lets you send SMS messages, manage contacts, and track deliveries programmatically. All requests are authenticated via API key or Bearer token.

1Get an API Key

Go to Developers page and generate a key.

2Make a Request

Send a POST request to /api/sms/send with your API key.

3Track Delivery

Check the response status. Messages are delivered in under 5 seconds.

1 Authentication

Include your API key in every request

All API requests require authentication. Include your API key in one of two ways:

Header (Recommended)
X-Api-Key: jqn_your_api_key_here
Bearer Token
Authorization: Bearer jqn_your_api_key_here

2 Send SMS

Send a single SMS message to one or more recipients

POST /api/sms/send

Request Body

sender_id
string
Required
Your approved sender ID (max 11 chars)
message
string
Required
The SMS text content (max 1,600 characters)
contacts
string
Required
Comma-separated phone numbers

Responses

200 OK — Success
{
  "service": {
    "id": 42,
    "sender_id": "JQUICKNET",
    "message": "Hello from JQuickNet API!",
    "contacts": "255712345678,255687654321",
    "status": "success",
    "created_at": "2026-07-12T12:00:00.000Z"
  }
}
400 Bad Request — Low Credits
{ "message": "Low credits. Please topup" }
401 Unauthorized
{ "message": "Invalid or inactive API key." }

3 Code Examples

Integration examples in popular languages

curl -X POST https://jquicknet.com/api/sms/send \
  -H "X-Api-Key: jqn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": "JQUICKNET",
    "message": "Hello from API",
    "contacts": "255712345678,255687654321"
  }'
const response = await fetch("https://jquicknet.com/api/sms/send", {
  method: "POST",
  headers: {
    "X-Api-Key": "jqn_your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    sender_id: "JQUICKNET",
    message: "Hello from API",
    contacts: "255712345678,255687654321"
  })
});

const data = await response.json();
console.log(data);
import requests

url = "https://jquicknet.com/api/sms/send"
headers = {
    "X-Api-Key": "jqn_your_api_key_here",
    "Content-Type": "application/json"
}
payload = {
    "sender_id": "JQUICKNET",
    "message": "Hello from API",
    "contacts": "255712345678,255687654321"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
<?php

$ch = curl_init("https://jquicknet.com/api/sms/send");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "X-Api-Key: jqn_your_api_key_here",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "sender_id" => "JQUICKNET",
        "message" => "Hello from API",
        "contacts" => "255712345678,255687654321"
    ])
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

4 Error Codes

Common HTTP status codes and their meanings

400 Bad Request — Invalid parameters, insufficient credits, or unapproved sender ID
401 Unauthorized — Invalid, missing, or revoked API key
403 Forbidden — Sender ID not owned by authenticated user
404 Not Found — Endpoint does not exist
429 Rate Limited — Too many requests, try again later
500 Server Error — Internal processing failure

5 Rate Limits

Request throttling to protect service stability

100
requests per 15 minutes
General API endpoints
10
requests per 15 minutes
Auth endpoints (login/signup)

6 Important Notes

Things to keep in mind when using the API

Need an API Key?

Generate your API key from the Developers page. You need at least one completed wallet top-up.