SMS Pin Verify API

https://smspinverify.com/api
Admin
SMS Pin Verify API provides temporary and rental phone numbers across multiple countries to receive...
Tokens:13,578
Snippets:73
Trust Score:9.5
Update:1 month ago
Show doc for...
Tokens:
Raw
### 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.
```
Tokens:
Raw