Holly SMS API Documentation

🚀 Real USA verification numbers API • ⚡ Instant integration • 🔒 Secure & reliable

🔥 Get API Key 📖 Quick Start Guide

🚀 Quick Start Guide

Get API Key

Make API Call

Use our REST API endpoints to get numbers and codes

Verify Account

Receive SMS codes and complete your verifications

🔐 Authentication

All API requests require authentication using an API key provided in the request parameters.

⚠️ Important: Always keep your API key secure and never share it in client-side code.

Error Response Example:

{
    "status": "error",
    "message": "Invalid API"
}

📋 All Service Short Names and Prices

GET https://hollysms.com/api/handler_api.php?api_key=$APIKEY&action=allServicePrice

Example Response:

{
    "status": "success",
    "message": "Service prices retrieved successfully",
    "services": [
        {
            "service_short_name": "7eleven",
            "service_name": "7-Eleven",
            "service_cost": "0.1"
        },
        {
            "service_short_name": "aarp",
            "service_name": "AARP",
            "service_cost": "0.35"
        }
    ]
}

💰 Get Balance

POST https://hollysms.com/api/handler_api.php?api_key=$APIKEY&action=getBalance

Parameters:

$APIKEY: Enter Your API Key

Example Response:

{
    "status": "success",
    "message": "Balance retrieved successfully",
    "balance": "8.40"
}

📱 Get Number

POST https://hollysms.com/api/handler_api.php?api_key=$APIKEY&action=getNumber&service=$SERVICE&max_price=$MAX_PRICE

Parameters:

service: Service short name (e.g., 'ggy')
max_price: Maximum price limit

Example Response:

{
    "status": "success",
    "message": "Number retrieved successfully",
    "number": "+19702914387",
    "service_id": 3595
}

💬 Get SMS Code

GET https://hollysms.com/api/handler_api.php?api_key=$APIKEY&action=getCodeApi&service_id=$SERVICE_ID

Example Response:

{
    "status": "success",
    "message": "Codes retrieved successfully",
    "service_id": "3592",
    "codes": "5555"
}

❌ Cancel Rental

POST https://hollysms.com/api/handler_api.php?api_key=$APIKEY&action=cancelRental&service_id=$SERVICE_ID

Example Response:

{
    "status": "success",
    "message": "Rental Deleted and Refunded"
}

⚠️ Important Notes

• Poll for SMS codes at 3-second intervals or longer

• Balance is refunded if no code is received after cancellation

• Always check the response status before processing data

• Keep your API key secure and never expose it in client-side code

🔧 Example Integration

Here's a simple workflow example:

1️⃣

Get Services

Fetch available services and prices

2️⃣

Get Number

Request a phone number for verification

3️⃣

Poll for SMS

Check for incoming verification code

4️⃣

Complete

Use the code or cancel if needed

💬 Need Help?

Our team is here to help you integrate Holly SMS API successfully

📧

Email Support

Get detailed help via email

💬

Live Chat

Instant support 24/7

📚

Documentation

Comprehensive guides

Ready to Start Building?

Get your API key and start integrating real USA verification numbers today

🚀 Instant setup • 📱 Real SIM numbers • 🔒 Secure API • 💰 Starting at $0.22

🔑 Get API Key - Start Now Login to Dashboard

💳 Secure payment • ⚡ Instant API access • 🛡️ 24-hour warranty included