What is the PVAPins API?

The PVAPins API allows you to integrate SMS verification into your apps, websites, or services using our secure endpoints.

How much does SMS verification cost?

Prices range from USD 0.1 to USD 5 depending on the country and service you select.

API Documentation | SMS Verification Platform

API Endpoints Documentation

Below are the available API endpoints for SMS verification services. Each endpoint includes detailed parameter descriptions and error handling information.

GET Load Countries

Endpoint:

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

Example Request:

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

Parameters:
• No parameters required - returns all available countries

Response Format:

[
  {
    "id": 58,
    "full_name": "USA",
    "link": "",
    "picture": "https://pvapins.com/uploads/images/106321864_us.webp"
  },
  {
    "id": 62,
    "full_name": "UK",
    "link": "",
    "picture": "https://pvapins.com/uploads/images/95838938_gb.webp"
  }
]
                    

Response Fields:
• id: Unique country identifier
• full_name: Full country name
• link: Country link (usually empty)
• picture: URL to country flag image

Notes:

This endpoint returns a JSON array of all available countries
No authentication required
Useful for populating country dropdowns in applications
Country names can be used with other API endpoints

GET Load Apps

Endpoint:

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

Example Request:

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

Parameters:
• country_id: Country ID to get apps for (required)

Response Format:

[
  {
    "id": 2548,
    "full_name": "Facebook40",
    "picture": "",
    "timestamp": "2025-08-13 10:25:32",
    "link": "https://pvapins.com/uploads/images/309182842_Facebook.webp",
    "trending": 1,
    "deduct": "0.91"
  },
  {
    "id": 2551,
    "full_name": "Gmail40",
    "picture": "",
    "timestamp": "2025-08-14 14:47:36",
    "link": "https://pvapins.com/uploads/images/221448043_Gmail.webp",
    "trending": 1,
    "deduct": "0.84"
  }
]
                    

Response Fields:
• id: Unique app identifier
• full_name: Full app name
• picture: App picture URL (usually empty)
• timestamp: Last update timestamp
• link: URL to app image
• trending: Trending status (1 = trending, 0 = not trending)
• deduct: Cost deduction amount

Notes:

This endpoint returns a JSON array of all available apps for a specific country
No authentication required
Useful for populating app dropdowns in applications
App names can be used with other API endpoints
Trending apps are marked with trending=1
Deduct field shows the cost for using this app

GET Check Rates

Endpoint:

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

Example Request:

                        https://api.pvapins.com/user/api/get_rates.php?customer=YOUR_API_KEY&country=malaysia
                    

Parameters:
• customer: Your API key (required)
• country: Country name to check rates for

Error Messages:

Customer Not Found

GET Get Number

Endpoint:

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

Example Request:

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

Parameters:
• customer: Your API key (required)
• app: Application name (e.g., google, whatsapp, telegram)
• country: Country name (e.g., malaysia, indonesia, philippines)
Rate Limit: 5 numbers per minute

Error Messages:

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

GET Get SMS

Endpoint:

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

Example Request:

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

Parameters:
• customer: Your API key (required)
• number: Phone number to check SMS for
• country: Country name
• app: Application name

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 Reject Number

Endpoint:

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

Example Request:

                        https://api.pvapins.com/user/api/get_reject_number.php?customer=YOUR_API_KEY&number=112869xxx&country=malaysia&app=google
                    

Parameters:
• customer: Your API key (required)
• number: Phone number to reject
• country: Country name
• app: Application name
Time Limit: 3 minutes per number

Error Messages:

Customer Not Found.
App Not Found.
Country Not Found.
Number Not Found.
Number Rejected.
Not able to reject.
Error 102, check back later.
Limit: 3 MINUTES PER NUMBER

GET Check Balance

Endpoint:

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

Example Request:

https://api.pvapins.com/user/api/get_balance.php?customer=YOUR_API_KEY

Parameters:
• customer: Your API key (required)

Error Messages:

Customer Not Found

GET Get History

Endpoint:

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

Example Request:

https://api.pvapins.com/user/api/get_history.php?customer=YOUR_API_KEY

Parameters:
• customer: Your API key (required)

Error Messages:

Customer Not Found

Rent Numbers API Endpoints

API endpoints for renting phone numbers for extended periods. These endpoints include the is_rent=1 parameter to distinguish from temporary numbers.

GET Load Countries (Rent)

Endpoint:

https://api.pvapins.com/user/api/load_countries.php?is_rent=1

Example Request:

https://api.pvapins.com/user/api/load_countries.php?is_rent=1

Parameters:
• is_rent: Set to 1 to get countries available for rent (required)
Note: This endpoint returns countries that support number rental services

Response Format:

[
  {
    "id": 58,
    "full_name": "USA",
    "link": "",
    "picture": "https://pvapins.com/uploads/images/106321864_us.webp"
  },
  {
    "id": 62,
    "full_name": "UK",
    "link": "",
    "picture": "https://pvapins.com/uploads/images/95838938_gb.webp"
  }
]
                        

Response Fields:
• id: Unique country identifier
• full_name: Full country name
• link: Country link (usually empty)
• picture: URL to country flag image

GET Load Apps (Rent)

Endpoint:

https://api.pvapins.com/user/api/load_apps.php?country_id=country_id&is_rent=1

Example Request:

https://api.pvapins.com/user/api/load_apps.php?country_id=58&is_rent=1

Parameters:
• country_id: Country ID to get apps for (required)
• is_rent: Set to 1 to get apps available for rent (required)
Note: This endpoint returns apps that support number rental services

Response Format:

[
  {
    "id": 2333,
    "full_name": "Rent Adidas",
    "picture": "",
    "timestamp": "2025-06-17 21:04:01",
    "link": "https://pvapins.com/uploads/images/27693480_Adidas.webp",
    "trending": 0,
    "deduct": "10.00"
  },
  {
    "id": 2349,
    "full_name": "Rent Airbnb",
    "picture": "",
    "timestamp": "2025-06-17 21:03:54",
    "link": "https://pvapins.com/uploads/images/211213183_Airbnb.webp",
    "trending": 0,
    "deduct": "10.00"
  }
]
                        

Notes:

This endpoint returns a JSON array of all available apps for rent in a specific country
No authentication required
Useful for populating app dropdowns in rental applications
App names can be used with other rental API endpoints
Trending apps are marked with trending=1
Deduct field shows the rental cost for using this app

GET Get Number (Rent)

Endpoint:

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

Example Request:

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

Success Response:

{
  "data": "112869xxx",
  "code": 100
}
                        

Error Response:

{
  "data": "Currently, The number is unavailable, Try again later",
  "code": 200
}
                        

Response Fields:
• data: Phone number (success) or error message (failure)
• code: Response code (100 = success, 200 = error)

Notes:

This endpoint is specifically for renting phone numbers for extended periods
Authentication required via API key
Rate limited to 5 numbers per minute
Returns a rented phone number that can be used for longer periods
Use the returned number with other rental-specific endpoints

GET Load Rented Numbers

Endpoint:

https://api.pvapins.com/user/api/load_rent.php?customer=apikey

Example Request:

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

Parameters:
• customer: Your API key (required)

Success Response:

[
  {
    "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",
    "app_picture": "",
    "app_link": "https://pvapins.com/uploads/images/282637414_Google,youtube,Gmail.webp",
    "country_name": "USA",
    "country_picture": "https://pvapins.com/uploads/images/106321864_us.webp",
    "country_link": "",
    "timestamp_readable": "17/08/2025 08:14 pm",
    "days": 2,
    "expiry": "2025-08-20 20:14:13"
  }
]
                        

Response Fields:
• id: Unique rental ID
• user_id: User identifier
• key_id: Key identifier
• app_id: Application ID
• number: Rented phone number
• deduct: Cost deduction amount
• duration: Rental duration in days
• country_id: Country identifier
• is_released: Release status (0 = active, 1 = released)
• auto_renew: Auto-renewal status (0 = disabled, 1 = enabled)
• received_message: Message count received
• api: API identifier
• timestamp: Rental start timestamp
• app_name: Application name
• app_picture: App picture URL
• app_link: App image link
• country_name: Country name
• country_picture: Country flag image
• country_link: Country link
• timestamp_readable: Human-readable timestamp
• days: Days remaining in rental
• expiry: Rental expiry date and time

Notes:

This endpoint retrieves all currently rented phone numbers for your account
Authentication required via API key
Returns detailed information about each rented number including expiry dates
Use this endpoint to manage and monitor all your rented numbers
The days field shows remaining rental days
Check is_released to see if a number is still active
Response includes country and app information for each rented number

GET Get SMS (Rent)

Endpoint:

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

Example Request:

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

Parameters:
• customer: Your API key (required)
• country: Country name (e.g., USA, UK, malaysia)
• app: Application name (e.g., Rent GPay GPlay GVoice)
• number: Rented phone number to check SMS for (required)

Success Response:

[
  {
    "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"
  }
]
                        

Response Fields:
• from: Sender of the SMS message
• message: Content of the SMS message
• timestamp: Date and time when the SMS was received

Notes:

This endpoint retrieves SMS messages for rented phone numbers
Authentication required via API key
Returns an array of SMS messages with sender, content, and timestamp
Use this endpoint to check for verification codes and other messages
Messages are returned in chronological order (newest first)
URL encode app names that contain spaces (e.g., "Rent GPay GPlay GVoice")

GET Reject Number (Rent)

Endpoint:

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

Example Request:

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

Success Response:

{
  "data": "Rejected",
  "code": 100
}
                        

Error Response:

{
  "data": "Cant Rejected",
  "code": 200
}
                        

Response Fields:
• data: Response message (success or error)
• code: Response code (100 = success, 200 = error)

Notes:

This endpoint allows you to reject/return a rented phone number
Authentication required via API key
Use this when you no longer need a rented number
Rejecting a number will release it back to the pool
Only works with numbers that are currently rented by your account
Check the response code to confirm if the rejection was successful

GET Renew Number (Rent)

Endpoint:

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

Example Request:

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

Success Response:

{
  "data": "Status Updated",
  "code": 100
}
                        

Error Response:

{
  "data": "Not enough balance",
  "code": 200
}
                        

Response Fields:
• data: Response message (success or error)
• code: Response code (100 = success, 200 = error)

Notes:

This endpoint allows you to extend the rental period of a phone number
Authentication required via API key
Use this to keep a rented number for additional time periods
Requires sufficient balance in your account
Only works with numbers that are currently rented by your account
Check the response code to confirm if the renewal was successful
Renewal will extend the rental by the original duration period

API Documentation

Ready to Get Started?

Get Phone Numbers

Receive SMS

Global Coverage

Secure & Reliable

API Endpoints Documentation

GET Load Countries

Endpoint:

Example Request:

Response Format:

GET Load Apps

Endpoint:

Example Request:

Response Format:

GET Check Rates

Endpoint:

Example Request:

GET Get Number

Endpoint:

Example Request:

GET Get SMS

Endpoint:

Example Request:

GET Reject Number

Endpoint:

Example Request:

GET Check Balance

Endpoint:

Example Request:

GET Get History

Endpoint:

Example Request:

Rent Numbers API Endpoints

GET Load Countries (Rent)

Endpoint:

Example Request:

Response Format:

GET Load Apps (Rent)

Endpoint:

Example Request:

Response Format:

GET Get Number (Rent)

Endpoint:

Example Request:

Success Response:

Error Response:

GET Load Rented Numbers

Endpoint:

Example Request:

Success Response:

GET Get SMS (Rent)

Endpoint:

Example Request:

Success Response:

GET Reject Number (Rent)

Endpoint:

Example Request:

Success Response:

Error Response:

GET Renew Number (Rent)

Endpoint:

Example Request:

Success Response:

Error Response:

Get Your API Key