### Get Balance

Source: https://pvapins.com/api_integrate

Retrieves the current account balance.

```APIDOC
## GET /user/api/get_balance.php

### Description
Retrieves the current account balance for the provided API key.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_balance.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key

### Request Example
```
https://api.pvapins.com/user/api/get_balance.php?customer=YOUR_API_KEY
```

### Error Messages
- Customer Not Found.
```

--------------------------------

### Get Balance

Source: https://pvapins.com/api

Retrieves the current account balance for the provided API key.

```APIDOC
## GET /user/api/get_balance.php

### Description
Retrieves the current account balance for the provided API key.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_balance.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
```

--------------------------------

### Get History

Source: https://pvapins.com/api_integrate

Retrieves the usage history for the account.

```APIDOC
## GET /user/api/get_history.php

### Description
Retrieves the usage history associated with your account.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_history.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key

### Request Example
```
https://api.pvapins.com/user/api/get_history.php?customer=YOUR_API_KEY
```

### Error Messages
- Customer Not Found.
```

--------------------------------

### Get Rates

Source: https://pvapins.com/api_integrate

Checks the pricing for a specific country. Requires your API key and the country name.

```APIDOC
## GET /user/api/get_rates.php

### Description
Checks the rates for a specific country.

### Method
GET

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

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **country** (string) - Required - Country name to check rates for

### Error Messages
- `Customer Not Found`
```

--------------------------------

### Get History

Source: https://pvapins.com/api

Retrieves the usage history for the account associated with the provided API key.

```APIDOC
## GET /user/api/get_history.php

### Description
Retrieves the usage history for the account associated with the provided API key.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_history.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
```

--------------------------------

### Get Number (Rent Flow)

Source: https://pvapins.com/api

Requests a phone number for repeated OTPs or longer access, using the rent flow. Requires authentication.

```APIDOC
## GET /user/api/get_number.php (Rent Flow)

### Description
Requests a phone number for repeated OTPs or longer access. This endpoint is part of the rent flow.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/get_number.php`

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **app** (string) - Required - The name of the application.
- **country** (string) - Required - The name of the country.
- **is_rent** (string) - Required - Set to `1` to indicate a rent request.
- **operator** (string) - Optional - The operator suffix, used when `app` is a group name.

### Request Example
```
curl -s 'https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=APP_NAME&country=COUNTRY_NAME&is_rent=1'
```

### Response
#### Success Response (200)
- **number** (string) - The requested phone number.
- **country** (string) - The country of the number.
- **app** (string) - The application associated with the number.
- **activation_id** (string) - Unique ID for this activation session.
```

--------------------------------

### Get Number

Source: https://pvapins.com/api_integrate

Requests a phone number for a given application and country. Supports requesting a new number or reusing an existing one.

```APIDOC
## GET /user/api/get_number.php

### Description
Requests a phone number for a specific app and country.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_number.php?customer=apikey&app=appname&country=countryname

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Required - App name
- **country** (string) - Required - Country name
- **number** (string) - Optional - Phone number to reuse

### Example Request (New Number)
https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=google&country=malaysia

### Example Request (Reuse Number)
https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=google&country=malaysia&number=112869xxx
```

--------------------------------

### Get Number (Temporary Flow)

Source: https://pvapins.com/api_integrate

Requests a phone number for a specific country and application. This endpoint requires authentication.

```APIDOC
## Get Number (Temporary Flow)

### Description
Requests a phone number for a specific country and application. This endpoint requires authentication.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/get_number.php`

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **app** (string) - Required - The name of the application or service.
- **country** (string) - Required - The name of the country.
- **operator** (string) - Optional - The operator suffix, used when `app` is a group name.

### Request Example
```bash
curl -s 'https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=APP_NAME&country=COUNTRY_NAME'
```

### Response
#### Success Response (200)
- **number** (string) - The requested phone number.
- **country** (string) - The country of the number.
- **app** (string) - The app associated with the number.
```

--------------------------------

### Get Number (Rent Flow)

Source: https://pvapins.com/api_integrate

Requests a phone number for repeated OTPs or longer access. This endpoint requires authentication and uses rent-specific parameters.

```APIDOC
## Get Number (Rent Flow)

### Description
Requests a phone number for repeated OTPs or longer access. This endpoint requires authentication and uses rent-specific parameters.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/get_number.php`

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **app** (string) - Required - The name of the application or service.
- **country** (string) - Required - The name of the country.
- **is_rent** (integer) - Required - Set to `1` to indicate a rent request.
- **operator** (string) - Optional - The operator suffix, used when `app` is a group name.

### Request Example
```bash
curl -s 'https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=APP_NAME&country=COUNTRY_NAME&is_rent=1'
```

### Response
#### Success Response (200)
- **number** (string) - The rented phone number.
- **country** (string) - The country of the number.
- **app** (string) - The app associated with the number.
- **expires_at** (string) - The expiration time of the rented number.
```

--------------------------------

### Get Number

Source: https://pvapins.com/api_integrate

Retrieves a phone number for a specified application, country, and optionally an operator suffix. Supports a reuse feature for recently used numbers.

```APIDOC
## GET /user/api/get_number.php

### Description
Retrieves a phone number for a specified application and country. The `operator` parameter can be used for combine-style services.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_number.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Required - Full application name, or group name when using `operator`
- **country** (string) - Required - Country name (e.g., malaysia, indonesia, philippines)
- **operator** (string) - Optional - Operator suffix for combine-style services
- **number** (string) - Optional - Phone number to reuse (for reuse feature only, must be within 15 minutes of creation and exist in user history)

### Request Example
```
https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=GROUP_NAME&country=malaysia&operator=OPERATOR_SUFFIX
```

### Request Example (Reuse Number)
```
https://api.pvapins.com/user/api/get_number.php?customer=apikey&app=google&country=malaysia&number=112869xxx
```

### Error Messages
- Customer Not Found.
- App Not Found.
- Country Not Found.
- Number not found in your history.
- Number reuse is only available for supported services.
- New Numbers registration in progress, please wait or check back later.
- Error 102, check back later.
```

--------------------------------

### Get SMS

Source: https://pvapins.com/api_integrate

Retrieves SMS messages for a given phone number, application, and country. Supports the optional `operator` parameter.

```APIDOC
## GET /user/api/get_sms.php

### Description
Retrieves SMS messages for a specific phone number. This endpoint can be used with or without the `operator` parameter.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_sms.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **number** (string) - Required - Phone number to check SMS for
- **country** (string) - Required - Country name
- **app** (string) - Required - Full application name, or group name when using `operator`
- **operator** (string) - Optional - Operator suffix, same pairing as Get number

### Request Example
```
https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=112869xxx&country=malaysia&app=google
```

### Request Example (with operator)
```
https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=112869xxx&country=malaysia&app=GROUP_NAME&operator=OPERATOR_SUFFIX
```

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

--------------------------------

### Get SMS / OTP (Rent Flow)

Source: https://pvapins.com/api_integrate

Polls for the SMS message containing the OTP for a rented phone number. This endpoint requires authentication.

```APIDOC
## Get SMS / OTP (Rent Flow)

### Description
Polls for the SMS message containing the OTP for a rented phone number. This endpoint requires authentication.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/get_sms.php`

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **number** (string) - Required - The rented phone number for which to fetch the OTP.
- **country** (string) - Required - The country of the phone number.
- **app** (string) - Required - The name of the application or service.
- **operator** (string) - Optional - The operator suffix, used when `app` is a group name.

### Request Example
```bash
curl -s 'https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=NUMBER&country=COUNTRY_NAME&app=APP_NAME'
```

### Response
#### Success Response (200)
- **sms** (string) - The received SMS message, typically containing the OTP.
- **country** (string) - The country of the number.
- **app** (string) - The app associated with the number.
```

--------------------------------

### Get Number

Source: https://pvapins.com/api

Retrieves a phone number for a specified application and country. Supports combining group names with operator suffixes and reusing previously used numbers within a 15-minute window.

```APIDOC
## GET /user/api/get_number.php

### Description
Retrieves a phone number for a specified application and country. Supports combining group names with operator suffixes and reusing previously used numbers within a 15-minute window.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_number.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Required - Full application name, or group name when using `operator`
- **country** (string) - Required - Country name (e.g., malaysia, indonesia, philippines)
- **operator** (string) - Optional - Operator suffix for combine-style services
- **number** (string) - Optional - Phone number to reuse (for reuse feature only, must exist in user history and be within 15 minutes of creation)

### Request Example
```
https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=google&country=malaysia
```

### Request Example (with operator)
```
https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=GROUP_NAME&country=malaysia&operator=OPERATOR_SUFFIX
```

### Request Example (reuse number)
```
https://api.pvapins.com/user/api/get_number.php?customer=apikey&app=google&country=malaysia&number=112869xxx
```

### Rate Limit
5 numbers per minute
```

--------------------------------

### Get SMS / OTP (Temporary Flow)

Source: https://pvapins.com/api_integrate

Polls for the SMS message containing the OTP for a given phone number. This endpoint requires authentication.

```APIDOC
## Get SMS / OTP (Temporary Flow)

### Description
Polls for the SMS message containing the OTP for a given phone number. This endpoint requires authentication. Recommended to poll every 3–6 seconds with backoff.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/get_sms.php`

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **number** (string) - Required - The phone number for which to fetch the OTP.
- **country** (string) - Required - The country of the phone number.
- **app** (string) - Required - The name of the application or service.
- **operator** (string) - Optional - The operator suffix, used when `app` is a group name.

### Request Example
```bash
# Poll every 3–6s with backoff
curl -s 'https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=NUMBER&country=COUNTRY_NAME&app=APP_NAME'
```

### Response
#### Success Response (200)
- **sms** (string) - The received SMS message, typically containing the OTP.
- **country** (string) - The country of the number.
- **app** (string) - The app associated with the number.
```

--------------------------------

### Get SMS (OTP) (Temporary Flow)

Source: https://pvapins.com/api

Polls for the One-Time Password (OTP) SMS associated with a previously obtained phone number. Requires authentication.

```APIDOC
## GET /user/api/get_sms.php

### Description
Polls for the One-Time Password (OTP) SMS associated with a specific phone number, country, and application.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/get_sms.php`

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **number** (string) - Required - The phone number for which to fetch the OTP.
- **country** (string) - Required - The country of the phone number.
- **app** (string) - Required - The name of the application.
- **operator** (string) - Optional - The operator suffix, used when `app` is a group name.

### Request Example
```
# Poll every 3–6s with backoff
curl -s 'https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=NUMBER&country=COUNTRY_NAME&app=APP_NAME'
```

### Response
#### Success Response (200)
- **sms** (string) - The received OTP code.
- **country** (string) - The country of the number.
- **app** (string) - The application associated with the number.
- **number** (string) - The phone number.
- **activation_id** (string) - Unique ID for this activation session.
```

--------------------------------

### Get SMS

Source: https://pvapins.com/api

Checks for an SMS code associated with a specific phone number, country, and application. This is used after obtaining a number to retrieve the verification code.

```APIDOC
## GET /user/api/get_sms.php

### Description
Checks for an SMS code associated with a specific phone number, country, and application. This is used after obtaining a number to retrieve the verification code. Supports combining group names with operator suffixes.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_sms.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **number** (string) - Required - Phone number to check SMS for
- **country** (string) - Required - Country name
- **app** (string) - Required - Full application name, or group name when using `operator`
- **operator** (string) - Optional - Operator suffix, same pairing as Get number

### Request Example
```
https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=112869xxx&country=malaysia&app=google
```

### Request Example (with operator)
```
https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=112869xxx&country=malaysia&app=GROUP_NAME&operator=OPERATOR_SUFFIX
```
```

--------------------------------

### Load Apps for a Country - No Auth

Source: https://pvapins.com/api_integrate

Retrieve the list of applications or services available for a specific country. This endpoint does not require authentication and takes a `country_id` as a parameter.

```bash
curl -s 'https://api.pvapins.com/user/api/load_apps.php?country_id=COUNTRY_ID'
```

--------------------------------

### Load Apps

Source: https://pvapins.com/api

Retrieves a list of apps available for rent in a specific country. Useful for populating app dropdowns in rental applications.

```APIDOC
## GET /user/api/load_apps.php

### Description
This endpoint returns apps that support number rental services.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_apps.php

### Parameters
#### Query Parameters
- **country_id** (integer) - Required - Country ID to get apps for.
- **is_rent** (integer) - Required - Set to 1 to get apps available for rent.

### Response
#### Success Response (200)
- **id** (integer) - Unique app identifier.
- **full_name** (string) - Full app name.
- **timestamp** (string) - Last update timestamp.
- **trending** (integer) - Trending status (1 = trending, 0 = not trending).
- **deduct** (string) - Cost deduction amount for rental.

### Response Example
[ { "id": 2333, "full_name": "Rent Adidas", "timestamp": "2025-06-17 21:04:01", "trending": 0, "deduct": "10.00" }, { "id": 2349, "full_name": "Rent Airbnb", "timestamp": "2025-06-17 21:03:54", "trending": 0, "deduct": "10.00" } ]
```

--------------------------------

### Load Countries - No Auth

Source: https://pvapins.com/api_integrate

Use this endpoint to retrieve a list of available countries and their corresponding IDs for your user interface. No authentication is required.

```bash
curl -s 'https://api.pvapins.com/user/api/load_countries.php'
```

--------------------------------

### Load Apps for Rent

Source: https://pvapins.com/api_integrate

Retrieves a list of apps available for rent in a specific country. Useful for populating dropdowns in rental applications.

```APIDOC
## GET /user/api/load_apps.php

### Description
This endpoint returns apps that support number rental services.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_apps.php

### Parameters
#### Query Parameters
- **country_id** (integer) - Required - Country ID to get apps for
- **is_rent** (integer) - Required - Set to 1 to get apps available for rent

### Response
#### Success Response (200)
- **id** (integer) - Unique app identifier
- **full_name** (string) - Full app name
- **timestamp** (string) - Last update timestamp
- **trending** (integer) - Trending status (1 = trending, 0 = not trending)
- **deduct** (string) - Cost deduction amount for rental

### Response Example
[ {"id": 2333, "full_name": "Rent Adidas", "timestamp": "2025-06-17 21:04:01", "trending": 0, "deduct": "10.00"}, {"id": 2349, "full_name": "Rent Airbnb", "timestamp": "2025-06-17 21:03:54", "trending": 0, "deduct": "10.00"} ]
```

--------------------------------

### Load Apps

Source: https://pvapins.com/api

Retrieves a list of applications available for a specific country. No authentication is required. Useful for populating app selection interfaces.

```APIDOC
## GET /user/api/load_apps.php

### Description
Returns a JSON array of all available apps for a specific country.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_apps.php?country_id=country_id

### Parameters
#### Query Parameters
- **country_id** (integer) - Required - Country ID to get apps for

### Response
#### Success Response (200)
- **id** (integer) - Unique app identifier
- **full_name** (string) - Full app name
- **timestamp** (string) - Last update timestamp
- **trending** (integer) - Trending status (1 = trending, 0 = not trending)
- **deduct** (string) - Cost deduction amount

### Response Example
[
  { "id": 2548, "full_name": "Facebook40", "timestamp": "2025-08-13 10:25:32", "trending": 1, "deduct": "0.91" },
  { "id": 2551, "full_name": "Gmail40", "timestamp": "2025-08-14 14:47:36", "trending": 1, "deduct": "0.84" }
]
```

--------------------------------

### Load Apps for Rent

Source: https://pvapins.com/api

Retrieves a list of applications available for number rental within a specified country. This endpoint is used in conjunction with `load_countries.php` to find available rental services.

```APIDOC
## GET /user/api/load_apps.php

### Description
Retrieves a list of applications available for number rental within a specified country. This endpoint is used in conjunction with `load_countries.php` to find available rental services.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_apps.php

### Parameters
#### Query Parameters
- **country_id** (integer) - Required - The ID of the country for which to load applications
- **is_rent** (integer) - Required - Set to 1 to get applications available for rent
```

--------------------------------

### Load Apps (Rent)

Source: https://pvapins.com/api_integrate

Retrieves a list of applications available for number rental within a specific country.

```APIDOC
## GET /user/api/load_apps.php

### Description
Retrieves a list of applications available for number rental within a specified country.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_apps.php

### Parameters
#### Query Parameters
- **country_id** (integer) - Required - The ID of the country for which to load applications
- **is_rent** (integer) - Required - Set to 1 to get applications available for rent
```

--------------------------------

### List Apps by Country

Source: https://pvapins.com/api_integrate

Retrieves a list of available applications for a specified country. This endpoint does not require authentication and helps in selecting the correct app for verification.

```APIDOC
## GET /user/api/load_apps.php

### Description
Returns a JSON array of all available apps for a specific country.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_apps.php?country_id=country_id

### Parameters
#### Query Parameters
- **country_id** (integer) - Required - Country ID to get apps for

### Response Example
[ { "id": 2548, "full_name": "Facebook40", "timestamp": "2025-08-13 10:25:32", "trending": 1, "deduct": "0.91" }, { "id": 2551, "full_name": "Gmail40", "timestamp": "2025-08-14 14:47:36", "trending": 1, "deduct": "0.84" } ]

### Response Fields
- `id` (integer) - Unique app identifier
- `full_name` (string) - Full app name
- `timestamp` (string) - Last update timestamp
- `trending` (integer) - Trending status (1 = trending, 0 = not trending)
- `deduct` (string) - Cost deduction amount
```

--------------------------------

### Load Countries (Rent)

Source: https://pvapins.com/api_integrate

Retrieves a list of countries that support number rental services.

```APIDOC
## GET /user/api/load_countries.php?is_rent=1

### Description
Retrieves a list of countries available for number rental services.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_countries.php

### Parameters
#### Query Parameters
- **is_rent** (integer) - Required - Set to 1 to get countries available for rent

### Request Example
```
https://api.pvapins.com/user/api/load_countries.php?is_rent=1
```

### Response Format
```json
[ { "id": 58, "full_name": "USA" }, { "id": 62, "full_name": "UK" } ]
```

### Response Fields
- **id** (integer) - Unique country identifier
- **full_name** (string) - Full country name
```

--------------------------------

### Load Apps for a Country

Source: https://pvapins.com/api_integrate

Retrieves a list of available applications or services for a specified country. This endpoint does not require authentication.

```APIDOC
## Load Apps

### Description
Retrieves a list of available applications or services for a specified country.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/load_apps.php?country_id=COUNTRY_ID`

### Parameters
#### Query Parameters
- **country_id** (string) - Required - The ID of the country for which to load apps.

### Request Example
```bash
curl -s 'https://api.pvapins.com/user/api/load_apps.php?country_id=COUNTRY_ID'
```

### Response
#### Success Response (200)
- **apps** (array) - List of apps available for the specified country.
```

--------------------------------

### Rent Number Request

Source: https://pvapins.com/api_integrate

Request a number for rent, suitable for repeated OTPs or longer access. Use the `is_rent=1` parameter. The optional `operator` parameter follows the same rules as the temporary flow.

```bash
curl -s 'https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=APP_NAME&country=COUNTRY_NAME&is_rent=1'
```

--------------------------------

### Request Temporary Number - Auth Required

Source: https://pvapins.com/api_integrate

Request a temporary phone number for a given application and country. This endpoint requires authentication using your API key as the `customer` parameter.

```bash
curl -s 'https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=APP_NAME&country=COUNTRY_NAME'
```

--------------------------------

### Rent a Phone Number

Source: https://pvapins.com/api_integrate

Rents a phone number for a specific application and country. Requires authentication with an API key and is rate-limited.

```APIDOC
## GET /user/api/rent.php

### Description
This endpoint is specifically for renting phone numbers for extended periods. It returns a rented phone number that can be used for longer periods.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/rent.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Required - Application name (e.g., google, whatsapp, telegram)
- **country** (string) - Required - Country name (e.g., malaysia, indonesia, philippines)

### Request Example
https://api.pvapins.com/user/api/rent.php?customer=YOUR_API_KEY&app=google&country=malaysia

### Response
#### Success Response (200)
- **data** (string) - Phone number (success)
- **code** (integer) - Response code (100 = success)

#### Error Response (200)
- **data** (string) - Error message (failure)
- **code** (integer) - Response code (200 = error)

### Response Example
{ "data": "112869xxx", "code": 100 }

### Notes
Rate Limit: 5 numbers per minute
```

--------------------------------

### Load Countries

Source: https://pvapins.com/api_integrate

Retrieves a list of available countries and their IDs for use in your UI. This endpoint does not require authentication.

```APIDOC
## Load Countries

### Description
Retrieves a list of available countries and their IDs for use in your UI.

### Method
GET

### Endpoint
`https://api.pvapins.com/user/api/load_countries.php`

### Parameters
None

### Request Example
```bash
curl -s 'https://api.pvapins.com/user/api/load_countries.php'
```

### Response
#### Success Response (200)
- **countries** (array) - List of countries with their IDs.
```

--------------------------------

### Reject Rented Phone Number

Source: https://pvapins.com/api

This endpoint allows you to reject or return a rented phone number. Authentication is required via API key. Use this when you no longer need a rented number.

```APIDOC
## GET /user/api/reject_rent.php

### Description
Rejects or returns a currently rented phone number.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/reject_rent.php?customer=apikey&app=appname&country=countryname&number=number

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Optional - Application name (e.g., google, whatsapp, telegram)
- **country** (string) - Optional - Country name (e.g., malaysia, indonesia, philippines)
- **number** (string) - Required - Phone number to reject

### Request Example
https://api.pvapins.com/user/api/reject_rent.php?customer=YOUR_API_KEY&app=google&country=malaysia&number=121345698

### Response
#### Success Response (100)
- **data** (string) - Response message (e.g., "Rejected")
- **code** (integer) - Response code (100 = success)

#### Error Response (200)
- **data** (string) - Response message (e.g., "Cant Rejected")
- **code** (integer) - Response code (200 = error)

#### Response Example
{
  "data": "Rejected",
  "code": 100
}
```

--------------------------------

### Request Number with Operator Suffix

Source: https://pvapins.com/api_integrate

When using services with a group name and operator suffix, specify both `app` (as the group name) and `operator` parameters. This pairing must be consistent across `get_number`, `get_sms`, and reject endpoints.

```bash
# get_number / get_sms / reject — use the same app + operator pair everywhere
curl -s 'https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=GROUP_NAME&country=COUNTRY_NAME&operator=OPERATOR_SUFFIX'
```

--------------------------------

### Load Rented Numbers

Source: https://pvapins.com/api_integrate

Retrieves a list of all currently rented phone numbers for your account. Provides detailed information about each rental.

```APIDOC
## GET /user/api/load_rent.php

### Description
This endpoint retrieves all currently rented phone numbers for your account, providing detailed information about each rental including expiry dates.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_rent.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key

### Request Example
https://api.pvapins.com/user/api/load_rent.php?customer=YOUR_API_KEY

### Response
#### Success Response (200)
- **id** (integer) - Unique rental ID
- **user_id** (string) - User identifier
- **key_id** (string) - Key identifier
- **key_id2** (null) - Key identifier 2
- **app_id** (integer) - Application ID
- **number** (string) - Rented phone number
- **deduct** (string) - Cost deduction amount
- **duration** (integer) - Rental duration in days
- **country_id** (string) - Country identifier
- **is_released** (integer) - Release status (0 = active, 1 = released)
- **auto_renew** (integer) - Auto-renewal status (0 = disabled, 1 = enabled)
- **received_message** (integer) - Message count received
- **api** (string) - API identifier
- **timestamp** (string) - Rental start timestamp
- **app_name** (string) - Application name
- **country_name** (string) - Country name
- **timestamp_readable** (string) - Human-readable timestamp
- **days** (integer) - Days remaining in rental
- **expiry** (string) - Rental expiry date and time

### Response Example
[ {"id": 728, "user_id": "80768a26e52ca6156081", "key_id": "840811", "key_id2": null, "app_id": 2327, "number": "12817437990", "deduct": "3.33", "duration": 3, "country_id": "58", "is_released": 0, "auto_renew": 0, "received_message": 0, "api": "1010", "timestamp": "2025-08-17 20:14:13", "app_name": "Rent GPay GPlay GVoice", "country_name": "USA", "timestamp_readable": "17/08/2025 08:14 pm", "days": 2, "expiry": "2025-08-20 20:14:13"} ]
```

--------------------------------

### List Countries

Source: https://pvapins.com/api_integrate

Retrieves a list of all available countries supported by the API. This endpoint does not require authentication and is useful for populating country selection interfaces.

```APIDOC
## GET /user/api/load_countries.php

### Description
Returns a JSON array of all available countries.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_countries.php

### Parameters
No parameters required.

### Response Example
[ { "id": 58, "full_name": "USA" }, { "id": 62, "full_name": "UK" } ]

### Response Fields
- `id` (integer) - Unique country identifier
- `full_name` (string) - Full country name
```

--------------------------------

### Load Countries for Rent

Source: https://pvapins.com/api

Retrieves a list of countries that support number rental services. This endpoint is specifically for identifying countries available for long-term number rentals.

```APIDOC
## GET /user/api/load_countries.php

### Description
Retrieves a list of countries that support number rental services. This endpoint is specifically for identifying countries available for long-term number rentals.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_countries.php

### Parameters
#### Query Parameters
- **is_rent** (integer) - Required - Set to 1 to get countries available for rent

### Request Example
```
https://api.pvapins.com/user/api/load_countries.php?is_rent=1
```

### Response
#### Success Response (200)
- **id** (integer) - Unique country identifier
- **full_name** (string) - Full country name

### Response Example
```json
[ { "id": 58, "full_name": "USA" }, { "id": 62, "full_name": "UK" } ]
```
```

--------------------------------

### Request Rented Number with Operator - PVAPins API

Source: https://pvapins.com/api

Requests a rented phone number using a group name and operator suffix. The 'app' parameter is the group name, and 'operator' is the suffix. Requires authentication.

```bash
curl -s 'https://api.pvapins.com/user/api/get_number.php?customer=YOUR_API_KEY&app=GROUP_NAME&country=COUNTRY_NAME&operator=OPERATOR_SUFFIX&is_rent=1'
```

--------------------------------

### Reject Rented Phone Number

Source: https://pvapins.com/api_integrate

This endpoint allows you to reject or return a rented phone number. Authentication is required via API key. This action releases the number back to the pool and only works for numbers currently rented by your account.

```APIDOC
## GET https://api.pvapins.com/user/api/reject_rent.php

### Description
Rejects or returns a rented phone number.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/reject_rent.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Optional - Application name (e.g., google, whatsapp, telegram)
- **country** (string) - Optional - Country name (e.g., malaysia, indonesia, philippines)
- **number** (string) - Required - Phone number to reject

### Response
#### Success Response (100)
- **data** (string) - Response message (e.g., "Rejected")
- **code** (integer) - Response code (100 for success)

#### Error Response (200)
- **data** (string) - Response message (e.g., "Cant Rejected")
- **code** (integer) - Response code (200 for error)

### Request Example
```
https://api.pvapins.com/user/api/reject_rent.php?customer=YOUR_API_KEY&app=google&country=malaysia&number=121345698
```

### Response Example (Success)
```json
{ "data": "Rejected", "code": 100 }
```

### Response Example (Error)
```json
{ "data": "Cant Rejected", "code": 200 }
```
```

--------------------------------

### Rent Phone Number

Source: https://pvapins.com/api

Rents a phone number for a specific application and country. This endpoint is specifically for renting phone numbers for extended periods.

```APIDOC
## GET /user/api/rent.php

### Description
This endpoint is specifically for renting phone numbers for extended periods.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/rent.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **app** (string) - Required - Application name (e.g., google, whatsapp, telegram).
- **country** (string) - Required - Country name (e.g., malaysia, indonesia, philippines).

### Request Example
https://api.pvapins.com/user/api/rent.php?customer=YOUR_API_KEY&app=google&country=malaysia

### Response
#### Success Response (200)
- **data** (string) - Phone number.
- **code** (integer) - Response code (100 = success).

#### Error Response (200)
- **data** (string) - Error message.
- **code** (integer) - Response code (200 = error).

### Response Example
{ "data": "112869xxx", "code": 100 }
```

--------------------------------

### Poll for SMS/OTP - Auth Required

Source: https://pvapins.com/api_integrate

Poll the SMS endpoint to retrieve the One-Time Password (OTP) for a requested number. Implement retry/backoff logic (e.g., 3-6 second intervals) to respect rate limits.

```bash
# Poll every 3–6s with backoff
curl -s 'https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=NUMBER&country=COUNTRY_NAME&app=APP_NAME'
```

--------------------------------

### Retrieve SMS Messages

Source: https://pvapins.com/api_integrate

This endpoint retrieves SMS messages for rented phone numbers. Authentication is required via API key. Messages are returned in chronological order (newest first).

```APIDOC
## GET https://api.pvapins.com/user/api/get_sms.php

### Description
Retrieves SMS messages for rented phone numbers.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/get_sms.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Optional - Application name (e.g., google, whatsapp, telegram)
- **country** (string) - Optional - Country name (e.g., malaysia, indonesia, philippines)
- **number** (string) - Optional - Phone number to retrieve messages for

### Response
#### Success Response (200)
- **from** (string) - Sender of the SMS message
- **message** (string) - Content of the SMS message
- **timestamp** (string) - Date and time when the SMS was received

### Response Example
```json
[ { "from": "22000", "message": "If someone requests this code, it is a scam. Use code 418494 only in Google Voice app to sign up. g.co/voice/help", "timestamp": "17/08/2025 08:15 pm" }, { "from": "Billing", "message": "3-day MDN rental started", "timestamp": "17/08/2025 08:14 pm" } ]
```
```

--------------------------------

### Check SMS for Rented Number

Source: https://pvapins.com/api_integrate

Checks for SMS messages associated with a specific rented phone number. Requires authentication and details of the rental.

```APIDOC
## GET /user/api/load_rent_code.php

### Description
This endpoint allows you to check for SMS messages for a specific rented phone number.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_rent_code.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **country** (string) - Required - Country name (e.g., USA, UK, malaysia)
- **app** (string) - Required - Application name (e.g., Rent GPay GPlay GVoice)
- **number** (string) - Required - Rented phone number to check SMS for
```

--------------------------------

### Load Rented Number Code

Source: https://pvapins.com/api

Checks for SMS messages associated with a specific rented phone number. Use this to retrieve verification codes or other messages sent to the rented number.

```APIDOC
## GET /user/api/load_rent_code.php

### Description
This endpoint checks for SMS messages associated with a specific rented phone number.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/load_rent_code.php

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key.
- **country** (string) - Required - Country name (e.g., USA, UK, malaysia).
- **app** (string) - Required - Application name (e.g., Rent GPay GPlay GVoice).
- **number** (string) - Required - Rented phone number to check SMS for.

### Request Example
https://api.pvapins.com/user/api/load_rent_code.php?customer=YOUR_API_KEY&country=USA&app=Rent%20GPay%20GPlay%20GVoice&number=12817437990
```

--------------------------------

### Poll SMS/OTP with Operator - PVAPins API

Source: https://pvapins.com/api

Polls for SMS/OTP using a group name and operator suffix. Requires authentication and the same app/operator pairing as the number request.

```bash
# get_number / get_sms / reject — use the same app + operator pair everywhere
curl -s 'https://api.pvapins.com/user/api/get_sms.php?customer=YOUR_API_KEY&number=NUMBER&country=COUNTRY_NAME&app=GROUP_NAME&operator=OPERATOR_SUFFIX'
```

--------------------------------

### Renew Rented Phone Number

Source: https://pvapins.com/api

This endpoint allows you to extend the rental period of a phone number. Authentication is required via API key. Requires sufficient balance in your account.

```APIDOC
## GET /user/api/rent_renew_number.php

### Description
Extends the rental period of a currently rented phone number.

### Method
GET

### Endpoint
https://api.pvapins.com/user/api/rent_renew_number.php?customer=apikey&app=appname&country=countryname&number=number

### Parameters
#### Query Parameters
- **customer** (string) - Required - Your API key
- **app** (string) - Optional - Application name (e.g., google, whatsapp, telegram)
- **country** (string) - Optional - Country name (e.g., malaysia, indonesia, philippines)
- **number** (string) - Required - Phone number to renew

### Request Example
https://api.pvapins.com/user/api/rent_renew_number.php?customer=YOUR_API_KEY&app=google&country=malaysia&number=121345698

### Response
#### Success Response (100)
- **data** (string) - Response message (e.g., "Status Updated")
- **code** (integer) - Response code (100 = success)

#### Error Response (200)
- **data** (string) - Response message (e.g., "Not enough balance")
- **code** (integer) - Response code (200 = error)

#### Response Example
{
  "data": "Status Updated",
  "code": 100
}
```