API Access

Get Balance

Endpoint:https://pvaotp.com/api/json/get_balance.php

Method: GET

Parameters:

• customer (required) - Your API key

Example Request:

https://pvaotp.com/api/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:https://pvaotp.com/api/json/get_history.php

Method: GET

Parameters:

• customer (required) - Your API key

Example Request:

https://pvaotp.com/api/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:https://pvaotp.com/api/json/get_rates.php

Method: GET

Parameters:

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

Example Request:

https://pvaotp.com/api/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 All Countries

Endpoint:https://pvaotp.com/api/json/get_countries.php

Method: GET

Parameters:

• customer (required) - Your API key

Example Request:

https://pvaotp.com/api/json/get_countries.php?customer=YOUR_API_KEY

Success Response (200):

{
    "success": true,
    "data": [
        { "id": 1,   "country": "USA",               "short_code": "US" },
        { "id": 31,  "country": "Canada",            "short_code": "CA" },
        { "id": 52,  "country": "United kingdom UK", "short_code": "GB" },
        { "id": 745, "country": "USA Rent",          "short_code": "US" }
    ]
}

Use the country value when calling get_rates, get_number, etc.

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

Get Number

Endpoint:https://pvaotp.com/api/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.
• area_code (optional) - 3-digit US area code filter. Example: 201.
• duration (optional) - Duration for number rental. Valid values: 15 minutes (default), 3 days, 7 days, 14 days, 25 days.

Example Request (Get New Number):

https://pvaotp.com/api/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA&duration=3 days

Example Request (Filter by US Area Code):

https://pvaotp.com/api/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA&area_code=201&duration=3 days

Example Request (Reuse Number):

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

How to request a specific number again: To get the same number again (like the “Specific Number” option on the homepage), call Get Number with the number parameter set to the full phone number (e.g. number=16143548416). Use the same app and country as when you first received that number. The number must belong to your account; reuse may be free within the app’s reuse window.

Area code + specific number: You can pass both number and area_code. If the requested number does not match the selected area code, the API returns an error.

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:https://pvaotp.com/api/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:

https://pvaotp.com/api/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:https://pvaotp.com/api/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:

https://pvaotp.com/api/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

Renew Number

Endpoint:https://pvaotp.com/api/json/renew_number.php

Method: GET

Parameters:

• customer (required) - Your API key
• number (required) - Phone number to renew
• duration (required) - Duration for renewal. Valid values: 15 minutes, 3 days, 7 days, 14 days, 25 days.

Example Request:

https://pvaotp.com/api/json/renew_number.php?customer=YOUR_API_KEY&number=15717412873&duration=3 days

Success Response (200):

{
    "success": true,
    "message": "Number renewed successfully.",
    "data": {
        "new_expiry": "2024-01-18",
        "new_balance": "95.50"
    }
}

Error Responses:

• {"success": false, "error": "Customer Not Found."} (400) - Customer parameter missing
• {"success": false, "error": "Number is required."} (400) - Number parameter missing
• {"success": false, "error": "Invalid duration parameter."} (400) - Duration parameter invalid
• {"success": false, "error": "Insufficient balance."} (400) - Not enough balance
• {"success": false, "error": "Renewal is only available after a message has been received."} (400) - No SMS received yet
• {"success": false, "error": "Number not found."} (404) - Number does not belong to user
• {"success": false, "error": "Access denied."} (500) - IP address blocked

Note: Available for selected numbers only.

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