📨 Send a Message


POST /api/v1/send

Send an SMS to any phone number.

Request Body

Parameter	Type	Required	Description
`api_key`	`string`	✅	Your Fire SMS API key
`to`	`string`	✅	Recipient number — include country code, no `+` (e.g. `27821234567`)
`text`	`string`	✅	The message body

Include the country code without a leading +. For South Africa, 0821234567 becomes 27821234567. For Lesotho, 59001234 becomes 26659001234.

Example Request

cURL


curl -X POST https://firesms.vercel.app/api/v1/send \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "to": "27821234567",
    "text": "Hello from Fire SMS"
  }'

JavaScript


const response = await fetch('https://firesms.vercel.app/api/v1/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    to: '27821234567',
    text: 'Hello from Fire SMS',
  }),
});
 
const data = await response.json();
 
if (data.status === 'success') {
  console.log('Sent! Message ID:', data.id);
} else {
  console.error('Failed:', data.error);
}

TypeScript


interface SendResponse {
  status: 'success' | 'error';
  id?: string;
  batch_id?: string;
  price?: number;
  remaining_credits?: number;
  error?: string;
}
 
const response = await fetch('https://firesms.vercel.app/api/v1/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: process.env.FIRESMS_API_KEY!,
    to: '27821234567',
    text: 'Hello from Fire SMS',
  }),
});
 
const data: SendResponse = await response.json();
 
if (data.status === 'success') {
  console.log('Sent! Message ID:', data.id);
} else {
  console.error('Failed:', data.error);
}

Python


import requests
import os
 
response = requests.post(
    'https://firesms.vercel.app/api/v1/send',
    json={
        'api_key': os.environ['FIRESMS_API_KEY'],
        'to': '27821234567',
        'text': 'Hello from Fire SMS',
    }
)
 
data = response.json()
 
if data['status'] == 'success':
    print('Sent! Message ID:', data['id'])
else:
    print('Failed:', data['error'])

PHP


<?php
 
$response = file_get_contents('https://firesms.vercel.app/api/v1/send', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/json',
        'content' => json_encode([
            'api_key' => getenv('FIRESMS_API_KEY'),
            'to'      => '27821234567',
            'text'    => 'Hello from Fire SMS',
        ]),
    ],
]));
 
$data = json_decode($response, true);
 
if ($data['status'] === 'success') {
    echo 'Sent! Message ID: ' . $data['id'];
} else {
    echo 'Failed: ' . $data['error'];
}

Response


{
  "status": "success",
  "id": "msg_abc123",
  "batch_id": "msg_abc123",
  "price": 0.25,
  "remaining_credits": 49.75
}

Field	Type	Description
`status`	`string`	`success` or `error`
`id`	`string`	Unique message ID
`price`	`number`	Cost charged for this message in ZAR
`remaining_credits`	`number`	Your remaining credit balance in ZAR

Error Response


{
  "status": "error",
  "error": "Insufficient credits. Please top up your account."
}

HTTP status	Meaning
`400`	Missing or invalid parameters
`401`	Invalid API key
`402`	Insufficient credits
`422`	No SMS provider configured — set one up in Settings
`500`	Send failed — check your provider credentials