FuxSMS API Reference

Send SMS messages and manage your account programmatically. All responses are JSON. All requests require a valid API key.

Overview

The FuxSMS REST API lets you send normal SMS, priority SMS, and bulk SMS to Philippine mobile numbers, as well as query your account balance and usage statistics. It is built on top of the Semaphore v4 gateway.

Base URL

All endpoints are relative to the root of this installation:

https://sms.fuxdevs.online/api/

Authentication

Every request must include your API key. It can be passed in three ways (evaluated in this order of priority):

Rate Limits

Rate limits are applied per API key, per endpoint, in a 1-hour rolling window. When a limit is exceeded the API returns HTTP 429.

Each response contains three headers to help you track your usage:

Response Format

All responses are application/json and follow this envelope:

{
  "status": "success",
  "data": { /* endpoint-specific payload */ }
}

{
  "status":  "error",
  "code":   422,
  "message": "Invalid number format. Must be 09XXXXXXXXX (11 digits)."
}

Every response also includes the fixed header:

X-SERVICE: FUX SMS

Error Codes

Credits & Pricing

Messages are billed in credits. The cost depends on the message type and the number of segments.

One segment = up to 160 characters. Messages longer than 160 characters are split into multi-part SMS (153 characters per segment from the second part onward). The API always reports the segment count and credits used in the response body.

Send Normal SMS

Send a single SMS to one Philippine mobile number using the standard queue. Costs 2 credits per segment.

Request Parameters

Example Request

curl -X POST https://sms.fuxdevs.online/api/message.php \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "number=09171234567" \
  -d "message=Hello from FuxSMS!"

Success Response 200

{
  "status": "success",
  "data": {
    "recipient":         "09171234567",
    "message":           "Hello from FuxSMS!",
    "type":              "normal",
    "segments":          1,
    "credits_used":      2,
    "credits_remaining": 498
  }
}

Send Priority SMS

Send a single SMS with priority delivery — processed before normal messages. Costs 3 credits per segment.

Request Parameters

Example Request

curl -X POST https://sms.fuxdevs.online/api/priority.php \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "number=09181234567" \
  -d "message=Your OTP is 493820"

Success Response 200

{
  "status": "success",
  "data": {
    "recipient":         "09181234567",
    "message":           "Your OTP is 493820",
    "type":              "priority",
    "segments":          1,
    "credits_used":      3,
    "credits_remaining": 497
  }
}

Send Bulk SMS

Send an SMS to 2–1000 recipients in a single API call. Uses the Semaphore bulk endpoint under the hood — one HTTP call regardless of recipient count — to avoid gateway rate limiting. Supports both normal and priority delivery.

Request Parameters

Example Request

curl -X POST https://sms.fuxdevs.online/api/bulk.php \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "numbers=09171234567,09181234567,09191234567" \
  -d "message=School event tomorrow at 8AM" \
  -d "type=normal"

Success Response 200

{
  "status": "success",
  "data": {
    "recipients_total":  3,
    "sent":              3,
    "failed":            0,
    "message":           "School event tomorrow at 8AM",
    "type":              "normal",
    "segments":          1,
    "credits_per_sms":   2,
    "credits_used":      6,
    "credits_remaining": 494
  }
}

Account Info

Returns the authenticated account's profile, current credit balance, and lifetime message statistics. Accepts both GET and POST.

Request Parameters

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://sms.fuxdevs.online/api/account.php

Success Response 200

{
  "status": "success",
  "data": {
    "username":           "jdelacruz",
    "name":               "Juan Dela Cruz",
    "role":               "user",
    "credits":            500,
    "stats": {
      "total_sent":         48,
      "total_credits_used": 96,
      "delivered":          45,
      "failed":             3
    }
  }
}

Number Format

All recipient numbers must be Philippine mobile numbers in the local format:

09XXXXXXXXX   ← 11 digits, starts with 09

SMS Segments

Standard SMS supports up to 160 characters per message. Messages that exceed this are split into linked multi-part messages, where each part uses 153 characters (7 bytes reserved for the UDH linking header).

Response Headers

Every response from the FuxSMS API includes these headers: