API reference

Get Account Balance

Retrieve your current account credit balance.

1curl "https://api.secureiosms.com/balance?api_key=<your_key>"

1{
2  "balance": "42.50"
3}

Get Available Services

Retrieve all available SMS services and their pricing by region.

1curl "https://api.secureiosms.com/services_regions?api_key=<your_key>"

1{
2  "data": {
3    "US": {
4      "Google": 1.5,
5      "Discord": 0.5,
6      "Amazon": 1
7    }
8  }
9}

Purchase Phone Number

Purchase a phone number for SMS verification. Credits are deducted immediately.

1curl "https://api.secureiosms.com/getnumber?api_key=<your_key>&service=google"

1{
2  "number": 12025551234,
3  "order_id": "ABC1234",
4  "country": "US",
5  "service": "google"
6}

Check Order Status

Check the status of an order and retrieve the SMS code if received.

1curl "https://api.secureiosms.com/checkstatus?api_key=<your_key>&id=<value>"

1{
2  "status": "activated",
3  "activation_code": "847291"
4}

Cancel Order

Cancel an active order. Credits are refunded automatically. The key may additionally be sent as an x-api-key header or inside the JSON body.

1curl -X POST "https://api.secureiosms.com/changestatus?api_key=<your_key>" \
2  -H "Content-Type: application/json" \
3  -d '{
4  "id": "<id>",
5  "action": "cancel"
6}'

1{
2  "success": true,
3  "message": "Order cancelled and refunded"
4}

Every response carries a standard status code alongside its JSON body.

1. 1Store your API key securely — never expose it in client-side code
2. 2Check order status periodically rather than continuously polling
3. 3Handle rate limits gracefully with exponential backoff
4. 4Always check the HTTP status code along with the response body
5. 5Join our Discord community for support and updates Open Discord →