API Access

Get Started with SMSPinVerify API

YOUR API KEY: XXXXXXXX

JSON API
API v1

Get Number

https://api.smspinverify.com/user/get_number.php?customer=apikey&app=appname&country=countryname&shownid=1

Example : http://api.smspinverify.com/user/get_number.php?customer=apikey&app=Google+Voice&country=USA&number=&shownid=1

Messages:

Customer Not Found.
App Not Found.
Country Not Found.
New Numbers registration in progress, please wait or check back later.
Error 102, check back later.

Pass shownid if you want to show id of number for reject. format: number|id

5 NUMBER PER MINUTE

Get History

https://api.smspinverify.com/user/get_history.php?customer=apikey

Messages:

Customer Not Found.

Check Balance

https://api.smspinverify.com/user/get_balance.php?customer=apikey

Messages:

Customer Not Found.

Check Rates & Business Codes

https://api.smspinverify.com/user/get_rates.php?customer=apikey&country=countryname

Messages:

Customer Not Found.

Reuse Number

https://api.smspinverify.com/user/get_number.php?customer=apikey&app=appname&country=countryname&number=number

Example : https://api.smspinverify.com/user/get_number.php?customer=apikey&app=Google+Voice&country=USA&number=17432592794

Messages:

Customer Not Found.
App Not Found.
Country Not Found.
New Numbers registration in progress, please wait or check back later.
Error 102, check back later.

5 NUMBER PER MINUTE

Get SMS

https://api.smspinverify.com/user/get_sms.php?customer=apikey&number=number&country=countryname&app=appname

Example : https://api.smspinverify.com/user/get_sms.php?customer=apikey&number=112869xxx&country=malaysia&app=google

Messages:

Customer Not Found.
Number Not Found.
You have not received any code yet.
Your balance is expired.
Error 102, check back later.

3 MINUTES PER NUMBER

Reject Number

https://api.smspinverify.com/user/reject_code.php?customer=apikey&number=number&n_id=n_id&country=countryname&app=appname

Example : https://api.smspinverify.com/user/reject_code.php?customer=apikey&number=112869xxx&country=malaysia&app=google

Messages:

Customer Not Found.
Number Not Found.
Number Rejected.
Cant Reject.
Your balance is expired.
Error 102, check back later.

Get n_id from History api

JSON API Overview

All JSON API endpoints return responses in a standardized format:

Success Response:{"success": true, "data": {...}} or {"success": true, "message": "..."}
Error Response:{"success": false, "error": "Error message"}

All responses include appropriate HTTP status codes (200, 400, 404, 429, 500, 503).

Get Balance

Endpoint:http://api.smspinverify.com/json/get_balance.php

Method: GET

Parameters:

customer (required) - Your API key

Example Request:

http://api.smspinverify.com/json/get_balance.php?customer=YOUR_API_KEY

Success Response (200):

{
    "success": true,
    "data": {
        "id": "123",
        "full_name": "John Doe",
        "email": "[email protected]",
        "balance": "100.50"
    }
}

Error Responses:

{"success": false, "error": "Customer Not Found."} (400) - Customer parameter missing or invalid
{"success": false, "error": "Customer not found."} (404) - Customer does not exist
{"success": false, "error": "Access denied."} (500) - IP address blocked
{"success": false, "error": "Database connection failed."} (500) - Database error
{"success": false, "error": "Database query failed."} (500) - Query error

Get History

Endpoint:http://api.smspinverify.com/json/get_history.php

Method: GET

Parameters:

customer (required) - Your API key

Example Request:

http://api.smspinverify.com/json/get_history.php?customer=YOUR_API_KEY

Success Response (200):

{
    "success": true,
    "data": [
        {
            "id": "8666290",
            "number": "15717412873",
            "message": "Your code is 123456",
            "country_name": "USA",
            "app_name": "Google Voice",
            "timestamp": "2024-01-15 10:30:00"
        },
        {
            "id": "8666289",
            "number": "15717412874",
            "message": "",
            "country_name": "USA",
            "app_name": "WhatsApp",
            "timestamp": "2024-01-15 10:25:00"
        }
    ]
}

Error Responses:

{"success": false, "error": "Customer Not Found."} (400) - Customer parameter missing
{"success": false, "error": "Access denied."} (500) - IP address blocked
{"success": false, "error": "Database connection failed."} (500) - Database error
{"success": false, "error": "Database query failed."} (500) - Query error

Get Rates & Business Codes

Endpoint:http://api.smspinverify.com/json/get_rates.php

Method: GET

Parameters:

customer (required) - Your API key
country (required) - Country name (e.g., "USA")

Example Request:

http://api.smspinverify.com/json/get_rates.php?customer=YOUR_API_KEY&country=USA

Success Response (200):

{
    "success": true,
    "data": [
        {
            "app": "Google Voice",
            "business_code": "go",
            "rate": "0.50"
        },
        {
            "app": "WhatsApp",
            "business_code": "wa",
            "rate": "0.75"
        }
    ]
}

Error Responses:

{"success": false, "error": "Customer Not Found."} (400) - Customer parameter missing
{"success": false, "error": "Country Not Found."} (400) - Country parameter missing
{"success": false, "error": "Country Not Found."} (404) - Country does not exist
{"success": false, "error": "Access denied."} (500) - IP address blocked
{"success": false, "error": "Database connection failed."} (500) - Database error
{"success": false, "error": "Database query failed."} (500) - Query error
{"success": false, "error": "Too many requests. Please wait."} (429) - Rate limit exceeded

Get Number

Endpoint:http://api.smspinverify.com/json/get_number.php

Method: GET

Parameters:

customer (required) - Your API key
app (required) - App name (e.g., "Google Voice") or business code
country (required) - Country name (e.g., "USA")
number (optional) - Phone number to reuse. When provided, the API will reuse this existing number instead of assigning a new one. The number must belong to your account and match the specified country/app combination.

Example Request (Get New Number):

http://api.smspinverify.com/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA

Example Request (Reuse Number):

http://api.smspinverify.com/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA&number=15717412873

Note: To reuse a number, include the number parameter with the phone number you want to reuse. The number must belong to your account and be in the same country/app combination.

Success Response (200):

{
    "success": true,
    "data": {
        "id": "8666290",
        "number": "15717412873",
        "deduction": "0.45"
    }
}

Error Responses:

{"success": false, "error": "Customer Not Found."} (400) - Customer parameter missing
{"success": false, "error": "App Not Found."} (400) - App parameter missing
{"success": false, "error": "Country Not Found."} (400) - Country parameter missing
{"success": false, "error": "Not Enough balance"} (400) - Insufficient balance
{"success": false, "error": "Customer Not Found."} (404) - Customer does not exist
{"success": false, "error": "App or Country Not Found."} (404) - App or country not found
{"success": false, "error": "Number is not available."} (403) - App restricted for user
{"success": false, "error": "No free channels available check after sometime."} (503) - No numbers available
{"success": false, "error": "Too many unused numbers. Service blocked for next 6 hours."} (429) - User blocked due to unused numbers
{"success": false, "error": "Access denied."} (500) - IP address blocked
{"success": false, "error": "Database connection failed."} (500) - Database error
{"success": false, "error": "Database query failed."} (500) - Query error
{"success": false, "error": "Error 102, check back later."} (500) - Provider not supported
{"success": false, "error": "Your balance is expired."} (400) - Account expired
{"success": false, "error": "SMS service error"} (503) - External SMS service error

Note: Rate limit: 5 numbers per minute

Get SMS

Endpoint:http://api.smspinverify.com/json/get_sms.php

Method: GET

Parameters:

customer (required) - Your API key
n_id (required) - Number ID (from get_number response or history)

Example Request:

http://api.smspinverify.com/json/get_sms.php?customer=YOUR_API_KEY&n_id=8666290

Success Response (200):

{
    "success": true,
    "message": "Your verification code is 123456"
}

Error Responses:

{"success": false, "error": "Customer Not Found."} (400) - Customer parameter missing
{"success": false, "error": "Number ID (n_id) is required."} (400) - n_id parameter missing
{"success": false, "error": "Number record not found."} (404) - Number ID does not exist
{"success": false, "error": "App or Country Not Found."} (404) - App or country not found
{"success": false, "error": "You have not received any code yet."} (400) - No SMS received yet
{"success": false, "error": "Too many requests. Please wait."} (429) - Rate limit exceeded (3 minutes per number)
{"success": false, "error": "Access denied."} (500) - IP address blocked
{"success": false, "error": "Database connection failed."} (500) - Database error
{"success": false, "error": "Database query failed."} (500) - Query error
{"success": false, "error": "SMS service error"} (503) - External SMS service error

Note: Rate limit: 3 minutes per number

Reject Number

Endpoint:http://api.smspinverify.com/json/reject_code.php

Method: GET

Parameters:

customer (required) - Your API key
n_id (required) - Number ID (from get_number response or history)

Example Request:

http://api.smspinverify.com/json/reject_code.php?customer=YOUR_API_KEY&n_id=8666290

Success Response (200):

{
    "success": true,
    "message": "Number Rejected."
}

Error Responses:

{"success": false, "error": "Customer Not Found."} (400) - Customer parameter missing
{"success": false, "error": "Number ID (n_id) is required."} (400) - n_id parameter missing
{"success": false, "error": "Number record not found."} (404) - Number ID does not exist
{"success": false, "error": "App or Country Not Found."} (404) - App or country not found
{"success": false, "error": "Cant Reject."} (400) - Cannot reject (number already used or time expired)
{"success": false, "error": "You have not received any code yet."} (400) - Cannot reject without SMS
{"success": false, "error": "Access denied."} (500) - IP address blocked
{"success": false, "error": "Database connection failed."} (500) - Database error
{"success": false, "error": "Database query failed."} (500) - Query error
{"success": false, "error": "SMS service error"} (503) - External SMS service error

Response Format Details

Success Responses:

All successful responses include "success": true
get_balance, get_history, get_rates, get_number return data in "data" field
get_sms, reject_code return message in "message" field
HTTP status code: 200

Error Responses:

All error responses include "success": false and "error" field with error message
HTTP status codes:
- 400 - Bad Request (missing/invalid parameters)
- 403 - Forbidden (access denied)
- 404 - Not Found (resource not found)
- 429 - Too Many Requests (rate limited)
- 500 - Internal Server Error (server/database errors)
- 503 - Service Unavailable (no numbers available, service errors)

Content-Type: All responses return Content-Type: application/json