### Get All Countries Response Source: https://smspinverify.com/api Example JSON response for the get_countries.php endpoint listing active countries. ```json [ {"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"} ] ``` -------------------------------- ### Get Balance API Request and Response Source: https://smspinverify.com/api Example request to check account balance and the corresponding success response. ```text https://api.smspinverify.com/json/get_balance.php?customer=YOUR_API_KEY ``` ```json { "success": true, "data": { "id": "123", "full_name": "John Doe", "email": "user@example.com", "balance": "100.50" } } ``` -------------------------------- ### Reject Number Request and Success Response Source: https://smspinverify.com/api Example of a GET request to reject a number and the corresponding 200 OK success response. ```text https://api.smspinverify.com/json/reject_code.php?customer=YOUR_API_KEY&n_id=8666290 ``` ```json { "success": true, "message": "Number Rejected." } ``` -------------------------------- ### Get SMS API Request Source: https://smspinverify.com/api Example request to retrieve SMS messages for a specific number. ```text https://api.smspinverify.com/user/get_sms.php?customer=apikey&number=112869xxx&country=malaysia&app=google ``` -------------------------------- ### GET /user/get_balance.php Source: https://smspinverify.com/api Checks the account balance for the user. ```APIDOC ## GET /user/get_balance.php ### Description Checks the account balance for the user. ### Method GET ### Endpoint https://api.smspinverify.com/user/get_balance.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. ### Request Example https://api.smspinverify.com/user/get_balance.php?customer=apikey ### Response #### Success Response (200) No specific response fields documented. ### Error Messages 1. Customer Not Found. ``` -------------------------------- ### Get SMS Request Source: https://smspinverify.com/api Example request to retrieve the SMS verification code for a specific number ID. ```http https://api.smspinverify.com/json/get_sms.php?customer=YOUR_API_KEY&n_id=8666290 ``` -------------------------------- ### Get New Number Request Source: https://smspinverify.com/api Example request to obtain a new phone number for a specific app and country. ```http https://api.smspinverify.com/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA&duration=3 days ``` -------------------------------- ### Check Rates with Duration Parameter Source: https://smspinverify.com/api Example JSON response when the duration parameter is set to 3 days. ```json [ {"app": "1688", "business_code": "1342", "duration": "3 days", "rate": "2.50"}, {"app": "Aeldra", "business_code": "1345", "duration": "3 days", "rate": "2.50"}, {"app": "WhatsApp", "business_code": "WhatsApp", "duration": "3 days", "rate": "3.50"} ] ``` -------------------------------- ### Check Rates & Business Codes Response Source: https://smspinverify.com/api Example JSON response for the get_rates.php endpoint showing standard rates and available durations for services. ```json [ { "app": "WhatsApp", "business_code": "wa", "rate": "2.20", "durations": {"3 days": "3.50", "7 days": "3.75", "14 days": "4.00", "25 days": "5.00"} }, { "app": "Some 15-minute only service", "business_code": "sos", "rate": "0.30", "durations": {} } ] ``` -------------------------------- ### Renew Number Request and Success Response Source: https://smspinverify.com/api Example of a GET request to renew a phone number duration and the corresponding 200 OK success response. ```text https://api.smspinverify.com/json/renew_number.php?customer=YOUR_API_KEY&number=15717412873&duration=3 days ``` ```json { "success": true, "message": "Number renewed successfully.", "data": { "new_expiry": "2024-01-18", "new_balance": "95.50" } } ``` -------------------------------- ### Check Rates with Renewal Type Source: https://smspinverify.com/api Example JSON response when the type parameter is set to renew. ```json [ { "app": "WhatsApp", "business_code": "WhatsApp", "rate": "8.00", "durations": {"15 minutes": "2.20", "3 days": "3.50", "7 days": "3.75", "14 days": "4.00", "25 days": "8.00"} } ] ``` -------------------------------- ### GET /user/get_countries.php Source: https://smspinverify.com/api Retrieves a list of all active countries supported by the platform. ```APIDOC ## GET /user/get_countries.php ### Description Returns a JSON array of all active countries with their IDs, full names, and short codes. ### Method GET ### Endpoint https://api.smspinverify.com/user/get_countries.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. ### Response #### Success Response (200) - **id** (integer) - Country ID. - **country** (string) - Full country name. - **short_code** (string) - ISO short code. #### Response Example [ {"id": 1, "country": "USA", "short_code": "US"} ] ``` -------------------------------- ### GET /json/get_balance.php Source: https://smspinverify.com/api Retrieve account balance and user information. This endpoint returns the current balance and user details. ```APIDOC ## GET /json/get_balance.php ### Description Retrieve account balance and user information. This endpoint returns the current balance and user details. ### Method GET ### Endpoint https://api.smspinverify.com/json/get_balance.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. ### Request Example https://api.smspinverify.com/json/get_balance.php?customer=YOUR_API_KEY ### Response #### Success Response (200) { "success": true, "data": { "id": "123", "full_name": "John Doe", "email": "user@example.com", "balance": "100.50" } } #### Error Responses - **Customer Not Found.** (400) - Customer parameter missing or invalid. - **Customer not found.** (404) - Customer does not exist. - **Access denied.** (500) - IP address blocked. - **Database connection failed.** (500) - Database error. - **Database query failed.** (500) - Query error. ``` -------------------------------- ### GET /json/get_sms.php Source: https://smspinverify.com/api Retrieves the SMS verification code sent to a rented number. Requires the customer API key and the number ID obtained from the Get Number response or history. ```APIDOC ## GET /json/get_sms.php ### Description Retrieves the SMS verification code sent to a rented number. Requires the customer API key and the number ID obtained from the Get Number response or history. ### Method GET ### Endpoint https://api.smspinverify.com/json/get_sms.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key - **n_id** (string) - Required - Number ID (from get_number response or history) ### Request Example https://api.smspinverify.com/json/get_sms.php?customer=YOUR_API_KEY&n_id=8666290 ### Response #### Success Response (200) - **success** (boolean) - Indicates success - **message** (string) - The SMS content, typically containing the verification code #### Response Example { "success": true, "message": "Your verification code is 123456" } ### Error Handling - **400** - `{"success": false, "error": "Customer Not Found."}` - Customer parameter missing - **400** - `{"success": false, "error": "Number ID (n_id) is required."}` - n_id parameter missing - **404** - `{"success": false, "error": "Number record not found."}` - Number ID does not exist - **404** - `{"success": false, "error": "App or Country Not Found."}` - App or country not found - **400** - `{"success": false, "error": "You have not received any code yet."}` - No SMS received yet - **429** - `{"success": false, "error": "Too many requests. Please wait."}` - Rate limit exceeded (3 minutes per number) - **500** - `{"success": false, "error": "Access denied."}` - IP address blocked - **500** - `{"success": false, "error": "Database connection failed."}` - Database error - **500** - `{"success": false, "error": "Database query failed."}` - Query error - **503** - `{"success": false, "error": "SMS service error"}` - External SMS service error ### Rate Limit 3 minutes per number ``` -------------------------------- ### Reuse Number API Request Source: https://smspinverify.com/api Example request to reuse a number with specified duration. ```text https://api.smspinverify.com/user/get_number.php?customer=apikey&app=Google+Voice&country=USA&number=17432592794&duration=3 days ``` -------------------------------- ### GET /user/get_history.php Source: https://smspinverify.com/api Retrieves the history of numbers requested by the user. ```APIDOC ## GET /user/get_history.php ### Description Retrieves the history of numbers requested by the user. ### Method GET ### Endpoint https://api.smspinverify.com/user/get_history.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. ### Request Example https://api.smspinverify.com/user/get_history.php?customer=apikey ### Response #### Success Response (200) No specific response fields documented. ### Error Messages 1. Customer Not Found. ``` -------------------------------- ### GET /json/get_countries.php Source: https://smspinverify.com/api Retrieves the list of all available countries. Requires the customer API key as a query parameter. ```APIDOC ## GET /json/get_countries.php ### Description Retrieves the list of all available countries. ### Method GET ### Endpoint https://api.smspinverify.com/json/get_countries.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key ### Request Example https://api.smspinverify.com/json/get_countries.php?customer=YOUR_API_KEY ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful - **data** (array) - List of country entries - **id** (integer) - Country ID - **country** (string) - Country name - **short_code** (string) - Country short code #### Response Example { "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" } ] } ### Error Responses - **400** - Customer parameter missing: {"success": false, "error": "Customer Not Found."} - **500** - IP address blocked: {"success": false, "error": "Access denied."} - **500** - Database error: {"success": false, "error": "Database connection failed."} ``` -------------------------------- ### Reject Number API Request Source: https://smspinverify.com/api Example request to reject a number using its n_id. ```text https://api.smspinverify.com/user/reject_code.php?customer=apikey&number=112869xxx&country=malaysia&app=google ``` -------------------------------- ### GET /user/get_rates.php Source: https://smspinverify.com/api Retrieves a list of services, business codes, and their associated rates for a specific country. Supports filtering by application, duration, and transaction type (buy or renew). ```APIDOC ## GET /user/get_rates.php ### Description Returns a JSON array of services in a specified country. Includes standard rates and long-term rental pricing. ### Method GET ### Endpoint https://api.smspinverify.com/user/get_rates.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. - **country** (string) - Required - The full name of the country. - **app** (string) - Optional - The service full name or business code. - **duration** (string) - Optional - The rental duration (e.g., '3 days'). - **type** (string) - Optional - Transaction type: 'buy' (default) or 'renew'. ### Response #### Success Response (200) - **app** (string) - Name of the service. - **business_code** (string) - Internal code for the service. - **rate** (string) - Standard price. - **durations** (object) - Map of duration keys to prices. #### Response Example [ { "app": "WhatsApp", "business_code": "wa", "rate": "2.20", "durations": {"3 days": "3.50", "7 days": "3.75"} } ] ``` -------------------------------- ### Get Number with Area Code Filter Source: https://smspinverify.com/api Example request to obtain a new phone number filtered by a specific US area code. ```http https://api.smspinverify.com/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA&area_code=201&duration=3 days ``` -------------------------------- ### GET /json/get_rates.php Source: https://smspinverify.com/api Retrieves rates and business codes for a specified country. Requires the customer API key and a country name as query parameters. ```APIDOC ## GET /json/get_rates.php ### Description Retrieves rates and business codes for a specified country. ### Method GET ### Endpoint https://api.smspinverify.com/json/get_rates.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key - **country** (string) - Required - Country name (e.g., "USA") ### Request Example https://api.smspinverify.com/json/get_rates.php?customer=YOUR_API_KEY&country=USA ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful - **data** (array) - List of rate entries - **app** (string) - Application name - **business_code** (string) - Business code for the application - **rate** (string) - Rate for the application #### Response Example { "success": true, "data": [ { "app": "Google Voice", "business_code": "go", "rate": "0.50" }, { "app": "WhatsApp", "business_code": "wa", "rate": "0.75" } ] } ### Error Responses - **400** - Customer parameter missing: {"success": false, "error": "Customer Not Found."} - **400** - Country parameter missing: {"success": false, "error": "Country Not Found."} - **404** - Country does not exist: {"success": false, "error": "Country Not Found."} - **500** - IP address blocked: {"success": false, "error": "Access denied."} - **500** - Database error: {"success": false, "error": "Database connection failed."} - **500** - Query error: {"success": false, "error": "Database query failed."} - **429** - Rate limit exceeded: {"success": false, "error": "Too many requests. Please wait."} ``` -------------------------------- ### Webhook Payload and Response Source: https://smspinverify.com/api Example of the JSON payload sent to your webhook URL and the expected HTTP 200 response. ```json { "message": "Your Google verification code is 482913", "otp": "482913", "user_id": "123456", "number": "14155551234", "country_id": "USA", "app_id": "Google Voice", "timestamp": "2026-02-25 10:24:15" } ``` ```json {"received": true} ``` -------------------------------- ### Get All Countries Request and Response Source: https://smspinverify.com/api Retrieves a list of all supported countries and their short codes. The returned country names should be used as parameters for other API calls. ```http https://api.smspinverify.com/json/get_countries.php?customer=YOUR_API_KEY ``` ```json { "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" } ] } ``` -------------------------------- ### Reuse Existing Number Request Source: https://smspinverify.com/api Example request to reuse a previously assigned phone number. ```http https://api.smspinverify.com/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA&number=15717412873 ``` -------------------------------- ### Renew Number API Request Source: https://smspinverify.com/api Example request to extend the duration of an existing number. ```text https://api.smspinverify.com/user/renew_number.php?customer=apikey&number=17432592794&duration=3 days ``` -------------------------------- ### Get SMS Success Response Source: https://smspinverify.com/api The JSON response containing the verification code. ```json { "success": true, "message": "Your verification code is 123456" } ``` -------------------------------- ### GET /json/get_history.php Source: https://smspinverify.com/api Retrieves the SMS history for the authenticated customer. Requires the customer API key as a query parameter. ```APIDOC ## GET /json/get_history.php ### Description Retrieves the SMS history for the authenticated customer. ### Method GET ### Endpoint https://api.smspinverify.com/json/get_history.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key ### Request Example https://api.smspinverify.com/json/get_history.php?customer=YOUR_API_KEY ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful - **data** (array) - List of SMS history entries - **id** (string) - Unique identifier for the SMS entry - **number** (string) - Phone number that received the SMS - **message** (string) - SMS message content - **country_name** (string) - Country name - **app_name** (string) - Application name - **timestamp** (string) - Timestamp of the SMS #### Response Example { "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 - **400** - Customer parameter missing: {"success": false, "error": "Customer Not Found."} - **500** - IP address blocked: {"success": false, "error": "Access denied."} - **500** - Database error: {"success": false, "error": "Database connection failed."} - **500** - Query error: {"success": false, "error": "Database query failed."} ``` -------------------------------- ### Get Number Success Response Source: https://smspinverify.com/api The JSON response returned upon successfully obtaining a number. ```json { "success": true, "data": { "id": "8666290", "number": "15717412873", "deduction": "0.45" } } ``` -------------------------------- ### GET /user/reject_code.php Source: https://smspinverify.com/api Reject a received code for a number. This endpoint allows you to reject a code that was received on a number. ```APIDOC ## GET /user/reject_code.php ### Description Reject a received code for a number. This endpoint allows you to reject a code that was received on a number. ### Method GET ### Endpoint https://api.smspinverify.com/user/reject_code.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. - **number** (string) - Required - The number associated with the code. - **n_id** (string) - Required - The n_id of the code. Get n_id from History API. - **country** (string) - Required - The country name (e.g., malaysia). - **app** (string) - Required - The app name (e.g., google). ### Request Example https://api.smspinverify.com/user/reject_code.php?customer=apikey&number=112869xxx&country=malaysia&app=google ### Response #### Success Response (200) No explicit success response format is documented. #### Error Responses - **Customer Not Found.** - Customer parameter missing or invalid. - **Number Not Found.** - Number parameter missing or invalid. - **Number Rejected.** - Number rejected successfully. - **Cant Reject.** - Cannot reject. - **Your balance is expired.** - Balance expired. - **Error 102, check back later.** - Temporary issue. ``` -------------------------------- ### Get Rates & Business Codes Request and Response Source: https://smspinverify.com/api Retrieves service rates and business codes for a specific country. Requires both the customer API key and the country name as parameters. ```http https://api.smspinverify.com/json/get_rates.php?customer=YOUR_API_KEY&country=USA ``` ```json { "success": true, "data": [ { "app": "Google Voice", "business_code": "go", "rate": "0.50" }, { "app": "WhatsApp", "business_code": "wa", "rate": "0.75" } ] } ``` -------------------------------- ### GET /user/get_number.php Source: https://smspinverify.com/api Reuse an existing number for a specified duration. This endpoint allows you to extend the usage of a number you already have. ```APIDOC ## GET /user/get_number.php ### Description Reuse an existing number for a specified duration. This endpoint allows you to extend the usage of a number you already have. ### Method GET ### Endpoint https://api.smspinverify.com/user/get_number.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. - **app** (string) - Required - The app name (e.g., Google Voice). - **country** (string) - Required - The country name (e.g., USA). - **number** (string) - Required - The number to reuse. - **duration** (string) - Optional - Duration for reuse. Default is 15 minutes. Allowed values: 15 minutes, 3 days, 7 days, 14 days, 25 days. ### Request Example https://api.smspinverify.com/user/get_number.php?customer=apikey&app=Google+Voice&country=USA&number=17432592794&duration=3 days ### Response #### Success Response (200) No explicit success response format is documented. #### Error Responses - **Customer Not Found.** - Customer parameter missing or invalid. - **App Not Found.** - App parameter missing or invalid. - **Country Not Found.** - Country parameter missing or invalid. - **New Numbers registration in progress, please wait or check back later.** - Temporary issue. - **Error 102, check back later.** - Temporary issue. ### Rate Limit 5 numbers per minute. ``` -------------------------------- ### GET /json/get_number.php Source: https://smspinverify.com/api Rents a new virtual phone number or reuses an existing one. Requires customer API key, app name, and country. Optional parameters allow filtering by area code, specifying a number to reuse, and setting rental duration. ```APIDOC ## GET /json/get_number.php ### Description Rents a new virtual phone number or reuses an existing one. Requires customer API key, app name, and country. Optional parameters allow filtering by area code, specifying a number to reuse, and setting rental duration. ### Method GET ### Endpoint https://api.smspinverify.com/json/get_number.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key - **app** (string) - Required - App name (e.g., "Google Voice") or business code - **country** (string) - Required - Country name (e.g., "USA") - **number** (string) - 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** (string) - Optional - 3-digit US area code filter. Example: `201`. - **duration** (string) - Optional - Duration for number rental. Valid values: `15 minutes` (default), `3 days`, `7 days`, `14 days`, `25 days`. ### Request Example https://api.smspinverify.com/json/get_number.php?customer=YOUR_API_KEY&app=Google+Voice&country=USA&duration=3 days ### Response #### Success Response (200) - **success** (boolean) - Indicates success - **data** (object) - Contains the rented number details - **id** (string) - Number ID - **number** (string) - The phone number - **deduction** (string) - Amount deducted from balance #### Response Example { "success": true, "data": { "id": "8666290", "number": "15717412873", "deduction": "0.45" } } ### Error Handling - **400** - `{"success": false, "error": "Customer Not Found."}` - Customer parameter missing - **400** - `{"success": false, "error": "App Not Found."}` - App parameter missing - **400** - `{"success": false, "error": "Country Not Found."}` - Country parameter missing - **400** - `{"success": false, "error": "Not Enough balance"}` - Insufficient balance - **404** - `{"success": false, "error": "Customer Not Found."}` - Customer does not exist - **404** - `{"success": false, "error": "App or Country Not Found."}` - App or country not found - **403** - `{"success": false, "error": "Number is not available."}` - App restricted for user - **503** - `{"success": false, "error": "No free channels available check after sometime."}` - No numbers available - **429** - `{"success": false, "error": "Too many unused numbers. Service blocked for next 6 hours."}` - User blocked due to unused numbers - **500** - `{"success": false, "error": "Access denied."}` - IP address blocked - **500** - `{"success": false, "error": "Database connection failed."}` - Database error - **500** - `{"success": false, "error": "Database query failed."}` - Query error - **500** - `{"success": false, "error": "Error 102, check back later."}` - Provider not supported - **400** - `{"success": false, "error": "Your balance is expired."}` - Account expired - **503** - `{"success": false, "error": "SMS service error"}` - External SMS service error ### Rate Limit 5 numbers per minute ``` -------------------------------- ### GET /user/get_sms.php Source: https://smspinverify.com/api Retrieve the SMS message received on a specified number. This endpoint returns the verification code when available. ```APIDOC ## GET /user/get_sms.php ### Description Retrieve the SMS message received on a specified number. This endpoint returns the verification code when available. ### Method GET ### Endpoint https://api.smspinverify.com/user/get_sms.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. - **number** (string) - Required - The number to check for SMS. - **country** (string) - Required - The country name (e.g., malaysia). - **app** (string) - Required - The app name (e.g., google). ### Request Example https://api.smspinverify.com/user/get_sms.php?customer=apikey&number=112869xxx&country=malaysia&app=google ### Response #### Success Response (200) No explicit success response format is documented. #### Error Responses - **Customer Not Found.** - Customer parameter missing or invalid. - **Number Not Found.** - Number parameter missing or invalid. - **You have not received any code yet.** - No SMS received yet. - **Your balance is expired.** - Balance expired. - **Error 102, check back later.** - Temporary issue. ### Rate Limit 3 minutes per number. ``` -------------------------------- ### GET /json/reject_code.php Source: https://smspinverify.com/api Rejects a number that has been received via get_number or history. Requires customer API key and number ID. Returns success message if rejection is successful. ```APIDOC ## GET /json/reject_code.php ### Description Rejects a number that has been received via get_number or history. Requires customer API key and number ID. Returns success message if rejection is successful. ### Method GET ### Endpoint https://api.smspinverify.com/json/reject_code.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key - **n_id** (integer) - Required - Number ID (from get_number response or history) ### Request Example https://api.smspinverify.com/json/reject_code.php?customer=YOUR_API_KEY&n_id=8666290 ### Response #### Success Response (200) - **success** (boolean) - true - **message** (string) - "Number Rejected." #### Response Example { "success": true, "message": "Number Rejected." } #### Error Responses - **400** - Customer Not Found. (customer parameter missing) - **400** - Number ID (n_id) is required. (n_id parameter missing) - **404** - Number record not found. (Number ID does not exist) - **404** - App or Country Not Found. (App or country not found) - **400** - Cant Reject. (Cannot reject - number already used or time expired) - **400** - You have not received any code yet. (Cannot reject without SMS) - **500** - Access denied. (IP address blocked) - **500** - Database connection failed. (Database error) - **500** - Database query failed. (Query error) - **503** - SMS service error (External SMS service error) ``` -------------------------------- ### GET /user/renew_number.php Source: https://smspinverify.com/api Renew a number for an additional duration. Renewal prices differ from purchase prices, so check rates first. ```APIDOC ## GET /user/renew_number.php ### Description Renew a number for an additional duration. Renewal prices differ from purchase prices, so check rates first. ### Method GET ### Endpoint https://api.smspinverify.com/user/renew_number.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. - **number** (string) - Required - The number to renew. - **duration** (string) - Required - Duration for renewal. Allowed values: 15 minutes, 3 days, 7 days, 14 days, 25 days. ### Request Example https://api.smspinverify.com/user/renew_number.php?customer=apikey&number=17432592794&duration=3 days ### Response #### Success Response (200) No explicit success response format is documented. #### Error Responses - **Customer Not Found.** - Customer parameter missing or invalid. - **Number Not Found.** - Number parameter missing or invalid. - **Insufficient balance.** - Insufficient balance. - **Renewal is only available after a message has been received.** - Renewal not allowed before receiving a message. - **Error 102, check back later.** - Temporary issue. ### Notes Renewal prices are not the same as purchase prices. Call get_rates.php?customer=apikey&country=USA&app=service&type=renew first to see what each extension length will cost. Available for selected numbers only. ``` -------------------------------- ### GET /user/get_number.php Source: https://smspinverify.com/api Requests a phone number for SMS verification. Supports optional parameters for specific number reuse, area code filtering, and duration selection. ```APIDOC ## GET /user/get_number.php ### Description Requests a phone number for SMS verification. Supports optional parameters for specific number reuse, area code filtering, and duration selection. ### Method GET ### Endpoint https://api.smspinverify.com/user/get_number.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key. - **app** (string) - Required - The app name (e.g., Google Voice). - **country** (string) - Required - The country name (e.g., USA). - **number** (string) - Optional - Full phone number to request a specific number again (reuse). Must use same app and country as when first obtained. - **area_code** (string) - Optional - 3-digit area code to filter numbers (e.g., 201). - **shownid** (integer) - Optional - Set to 1 to include the number ID in the response. - **duration** (string) - Optional - Duration for the number. Allowed values: 15 minutes (default), 3 days, 7 days, 14 days, 25 days. Long durations only for US numbers and services with price set. ### Request Example https://api.smspinverify.com/user/get_number.php?customer=apikey&app=Google+Voice&country=USA&number=&shownid=1&duration=3 days ### Response #### Success Response (200) - **number** (string) - The phone number (e.g., 14155551234). - **n_id** (string) - The number ID, returned when shownid=1, format: number|n_id. #### Response Example 14155551234|987654 ### Error Messages 1. Customer Not Found. 2. App Not Found. 3. Country Not Found. 4. Duration not available for this service. 5. New Numbers registration in progress, please wait or check back later. 6. Error 102, check back later. ``` -------------------------------- ### Get History Request and Response Source: https://smspinverify.com/api Retrieves transaction history using the customer API key. The response includes a list of SMS records with details like ID, number, message, and timestamp. ```http https://api.smspinverify.com/json/get_history.php?customer=YOUR_API_KEY ``` ```json { "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" } ] } ``` -------------------------------- ### GET /json/renew_number.php Source: https://smspinverify.com/api Renews a phone number for a specified duration. Requires customer API key, phone number, and duration. Returns new expiry date and balance. ```APIDOC ## GET /json/renew_number.php ### Description Renews a phone number for a specified duration. Requires customer API key, phone number, and duration. Returns new expiry date and balance. ### Method GET ### Endpoint https://api.smspinverify.com/json/renew_number.php ### Parameters #### Query Parameters - **customer** (string) - Required - Your API key - **number** (string) - Required - Phone number to renew - **duration** (string) - Required - Duration for renewal. Valid values: `15 minutes`, `3 days`, `7 days`, `14 days`, `25 days`. ### Request Example https://api.smspinverify.com/json/renew_number.php?customer=YOUR_API_KEY&number=15717412873&duration=3 days ### Response #### Success Response (200) - **success** (boolean) - true - **message** (string) - "Number renewed successfully." - **data** (object) - Contains new_expiry and new_balance - **new_expiry** (string) - New expiry date - **new_balance** (string) - New balance #### Response Example { "success": true, "message": "Number renewed successfully.", "data": { "new_expiry": "2024-01-18", "new_balance": "95.50" } } #### Error Responses - **400** - Customer Not Found. (customer parameter missing) - **400** - Number is required. (Number parameter missing) - **400** - Invalid duration parameter. (Duration parameter invalid) - **400** - Insufficient balance. (Not enough balance) - **400** - Renewal is only available after a message has been received. (No SMS received yet) - **404** - Number not found. (Number does not belong to user) - **500** - Access denied. (IP address blocked) ### Note Available for selected numbers only. ``` -------------------------------- ### Webhook Source: https://smspinverify.com/api Webhook configuration for receiving SMS messages. When an SMS is found during get_sms processing, a POST request is sent to your webhook URL. ```APIDOC ## Webhook ### Description Webhook configuration for receiving SMS messages. When an SMS is found during get_sms processing, a POST request is sent to your webhook URL. ### How It Works 1. Set your Webhook URL in account settings (must be HTTPS). 2. Call get_number.php with shownid=1 to receive number|n_id. 3. Call get_sms.php using that number. When SMS is found, API returns the message and also sends a webhook POST to your URL. ### Webhook Request - **Method:** POST - **Content-Type:** application/json ### Example Webhook Payload { "message": "Your Google verification code is 482913", "otp": "482913", "user_id": "123456", "number": "14155551234", "country_id": "USA", "app_id": "Google Voice", "timestamp": "2026-02-25 10:24:15" } ### Response Your endpoint should reply with HTTP 200 (any response body is fine). ### Example Endpoint Response {"received": true} ### Notes Webhook is sent only when a code is found during get_sms processing. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.