What is a virtual phone number?

A virtual phone number is a real, working phone number that exists online — not tied to a physical SIM card. You can use it to receive SMS and OTP verification codes for apps like WhatsApp, Google, Telegram, and 500+ other services.

Which countries are available on PingNum?

PingNum offers virtual numbers from 5 countries: USA (VOIP and Non-VOIP), United Kingdom, Canada, Hong Kong, and Indonesia.

How long does it take to receive an SMS?

SMS delivery on PingNum is typically under 3 seconds. Once you enter your virtual number into an app and request the verification code, it appears in your PingNum dashboard almost instantly.

Can I extend my virtual number session?

Yes! PingNum's unique Extend feature lets you keep the same number active for as long as you need, with a single click. This is a feature most competitors do not offer.

What payment methods does PingNum accept?

PingNum accepts cryptocurrency payments. You can top up your wallet and pay per use — no subscription or monthly fees required.

Is it legal to use virtual phone numbers?

Yes, using virtual phone numbers for SMS verification is legal. They are widely used by developers, businesses, and privacy-conscious individuals to protect their real phone numbers.

PingNum — Virtual SMS Numbers | Receive OTP Online

📊 Spending Analytics

Loading...

✅ Active Numbers

Loading your numbers...

📋 Order Management

Loading...

⏳ Free Extension Section

Numbers without SMS can be extended for free here.

Loading...

📱 SMS History

Loading SMS history...

💳 Recharge Balance

Add funds with crypto. Auto-confirmed. Minimum $12.

Amount (USD)

Select Cryptocurrency

Loading coins...

💳 Recharge History

Loading...

📊 Transactions & Billing

Manage your financial records and purchase history.

💸

All Transactions

View income and expenses

🛍️

Purchase History

Your number purchase logs

Transactions

Loading transactions...

Purchase History

Loading...

↗️ Transfer Funds or Numbers

Select what you would like to transfer to another PingNum user.

💰

Transfer Balance

Send funds instantly

📱

Transfer Number

Move active numbers

↗ Transfer Balance

Send balance to another user instantly.

Recipient Email

Amount (USD)

📱 Transfer Number

Transfer an active number to another user. Recipient must pay to activate.

Recipient Email

Number to Transfer

Total Referrals

—

Bonuses Paid

—

Total Earned

—

from referrals

🔗 Your Referral Link

Earn bonus credit for every friend who joins and recharges.

👥 Friends You Referred

Loading...

🔌 API Access

Use your API key to integrate PingNum into your own platform or automate number purchasing programmatically.

Your API Key

📖 API Documentation

🌐 Basic Information

API Base URL

https://pingnum.com

All endpoints format: https://pingnum.com + endpoint path

Example: https://pingnum.com/api/user/apps

API Request Rate Limits

Scope	Max per 60s	Ban duration if exceeded
Per IP	120	600 seconds (10 minutes)
Per API Key	60	600 seconds (10 minutes)

Stricter Routes

Path	IP / 60s	Key / 60s	Ban duration
/api/user/buy	20	10	900 seconds
/api/user/apps	30	20	600 seconds
/api/user/sms/:id	60	30	300 seconds

When limits are hit: HTTP 429 is returned. After a ban is applied, further calls from the same IP or key may be rejected until the ban expires.

🚀 Quick Start

1. Get API Key — Go to Dashboard → API Access. Click Generate New Key and copy your key.

2. Set Request Header — All API requests must include:

Header	Value
X-Api-Key	your_api_key_here
Content-Type	application/json (POST requests only)

3. Make your first request

curl -X GET "https://pingnum.com/api/user/me" \ -H "X-Api-Key: your_api_key_here"

🔐 Authentication

Add the following header to every API request:

X-Api-Key: your_api_key_here

🔒 Keep your key secure — do not expose it in client-side code

🔄 Regenerate your key anytime from the API Access tab

🚫 Do not share or commit your key to public repositories

📊 API Overview

Module	Endpoint	Method	Description
Account	/api/user/me	GET	Get account info & balance
Account	/api/user/balance	GET	Get wallet balance
Numbers	/api/user/apps	GET	Get available numbers list
Purchase	/api/user/buy	POST	Buy a number
SMS	/api/user/sms/:item_id	GET	Get received SMS
Session	/api/user/extend/:item_id	POST	Extend session by 15 min
Orders	/api/user/orders	GET	Get order history

📝 Detailed API Documentation

GET /api/user/me Get Account Info

Returns your account name, email and balance.

Request Example

curl -X GET "https://pingnum.com/api/user/me" \ -H "X-Api-Key: your_api_key_here"

Response Fields

Field	Type	Description
ok	bool	true on success
name	string	Account name
email	string	Account email
balance	float	Wallet balance (USD)

Response Example

{ "ok": true, "name": "John", "email": "john@email.com", "balance": 5.00 }

GET /api/user/balance Get Balance

Returns your current wallet balance in USD.

Request Example

curl -X GET "https://pingnum.com/api/user/balance" \ -H "X-Api-Key: your_api_key_here"

Response Fields

Field	Type	Description
ok	bool	true on success
balance	float	Current wallet balance (USD)

Response Example

{ "ok": true, "balance": 12.50 }

GET /api/user/apps Get Number List

Returns all available number apps with pricing.

Request Parameters

Parameter	Type	Required	Default	Description
type	int	No	1	1=New, 2=Restart, 3=Renew
search	string	No	—	Filter by app name (fuzzy)
cate_id	int	No	—	2=US VOIP, 5=US Non-VOIP, 3=Canada, 4=HK, 6=UK, 7=Indonesia

Request Example

curl -X GET "https://pingnum.com/api/user/apps?type=1&search=whatsapp" \ -H "X-Api-Key: your_api_key_here"

Response Fields (data array)

Field	Type	Description
app_id	int	App ID — use in /buy
name	string	App name (e.g. WhatsApp)
country	string	Country name
flag	string	Country flag emoji
cate_id	int	Category ID — use in /buy
price_t1	float	Price for type=1 (New) in USD
price_t2	float	Price for type=2 (Restart) in USD
price_t3	float	Price for type=3 (Renew) in USD
stock	int / null	Available quantity (null if hidden)

Response Example

{ "ok": true, "data": [ { "app_id": 1, "name": "WhatsApp", "country": "United States (VOIP)", "flag": "🇺🇸", "cate_id": 2, "price_t1": 0.15, "price_t2": 0.10, "price_t3": 0.08, "stock": 150 } ]}

POST /api/user/buy Buy a Number

Purchase a phone number. Balance is deducted instantly.

Request Parameters

Parameter	Type	Required	Default	Description
app_id	int	Yes	—	App ID from /apps
cate_id	int	Yes	—	Category ID from /apps
type	int	No	1	1=New, 2=Restart, 3=Renew
num	int	No	1	Purchase quantity (max 50)
prefix	string	No	—	Specify area code prefix (e.g. "212")

Request Example

curl -X POST "https://pingnum.com/api/user/buy" \ -H "X-Api-Key: your_api_key_here" \ -H "Content-Type: application/json" \ -d '{ "app_id": 1, "cate_id": 2, "type": 1, "num": 1 }'

Response Fields

Field	Type	Description
ordernum	string	Order number
count	int	Number of items purchased
total_charged	float	Amount deducted (USD)
balance_remaining	float	Balance after purchase (USD)
session_minutes	int	Session duration in minutes
items[].id	int	Item ID — use for /sms and /extend
items[].tel	string	Phone number
items[].end_time	string	Provider expiry date
items[].session_end	datetime	PingNum session expiry

Response Example

{ "ok": true, "data": { "ordernum": "260609123456", "count": 1, "total_charged": 0.15, "balance_remaining": 12.35, "session_minutes": 360, "items": [{ "id": 42, "tel": "12025551234", "end_time": "2026-07-31 00:00:00", "session_end": "2026-06-09T12:00:00Z" }] }}

GET /api/user/sms/:item_id Get SMS

Get received SMS for a purchased number. Poll every 5–10 seconds until OTP arrives.

Path Parameter

Parameter	Type	Required	Description
item_id	int	Yes	Item ID from /buy response (items[].id)

Request Example

curl -X GET "https://pingnum.com/api/user/sms/42" \ -H "X-Api-Key: your_api_key_here"

Response Fields

Field	Type	Description
number	string	Phone number
app	string	App name
status	string	active / expired
session_end	datetime	Session expiry time
sms[].content	string	Full SMS text
sms[].otp_code	string	Extracted OTP / verification code
sms[].received_at	datetime	Time SMS was received

Response Example

{ "ok": true, "number": "12025551234", "app": "WhatsApp", "status": "active", "session_end": "2026-06-09T12:00:00Z", "sms": [{ "content": "Your WhatsApp code is 123-456", "otp_code": "123456", "received_at": "2026-06-09T09:05:00Z" }] }

POST /api/user/extend/:item_id Extend Session

Extend the session of a number by 15 minutes. Costs 50% of the original unit price.

Path Parameter

Parameter	Type	Required	Description
item_id	int	Yes	Item ID from /buy response (items[].id)

Request Example

curl -X POST "https://pingnum.com/api/user/extend/42" \ -H "X-Api-Key: your_api_key_here"

Response Fields

Field	Type	Description
session_end	datetime	New session expiry (extended by 15 min)
cost	float	Amount deducted (USD)
balance_remaining	float	Balance after extend (USD)

Response Example

{ "ok": true, "session_end": "2026-06-09T12:15:00Z", "cost": 0.075, "balance_remaining": 12.275 }

GET /api/user/orders Get Order List

Returns your recent orders. Maximum 100 per request.

Request Parameters

Parameter	Type	Required	Default	Description
limit	int	No	20	Number of records to return (max 100)

Request Example

curl -X GET "https://pingnum.com/api/user/orders?limit=20" \ -H "X-Api-Key: your_api_key_here"

Response Fields (data array)

Field	Type	Description
id	int	Order ID
ordernum	string	Order number
app_name	string	App name
quantity	int	Numbers purchased
total_price	float	Total charged (USD)
status	string	active / expired
numbers	string	Comma-separated phone numbers
item_ids	string	Comma-separated item IDs (use for /sms)

Response Example

{ "ok": true, "data": [{ "id": 10, "ordernum": "260609123456", "app_name": "WhatsApp", "quantity": 1, "total_price": 0.15, "status": "active", "numbers": "12025551234", "item_ids": "42" }]}

📦 Response Format

Success Response

{ "ok": true, "data": { ... } }

Error Response

{ "ok": false, "msg": "Error description" }

❌ Error Code Description

HTTP Code	Meaning	Description
200	Success	ok: true — request successful
400	Bad Request	Missing required field or insufficient balance
401	Unauthorized	Invalid or missing API key
404	Not Found	Item not found or does not belong to your account
429	Too Many Requests	Rate limit exceeded — slow down and retry after ban expires
500	Server Error	Provider error — check msg field for details

Common Error Messages

"Invalid API key" — Key is wrong or not generated yet

"Insufficient balance" — Top up your wallet and try again

"App not found or unavailable" — app_id is invalid or stock is 0

"Service list temporarily unavailable" — Provider API is down; retry in a few minutes

"Number has fully expired on the provider" — Cannot extend; provider end_time has passed

💻 Sample Code

<?php $apiKey = 'your_api_key_here'; $base = 'https://pingnum.com'; function pingnum($path, $method='GET', $body=null) { global $apiKey, $base; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $base.$path); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $headers = ['X-Api-Key: '.$apiKey, 'Content-Type: application/json']; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); if ($method === 'POST') { curl_setopt($ch, CURLOPT_POST, true); if ($body) curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body)); } $res = curl_exec($ch); curl_close($ch); return json_decode($res, true); } // Check balance $r = pingnum('/api/user/balance'); echo "Balance: $" . $r['balance'] . "\n"; // Get WhatsApp numbers (US) $r = pingnum('/api/user/apps?search=whatsapp&cate_id=2'); $app = $r['data'][0]; echo "App: " . $app['name'] . " — $" . $app['price_t1'] . "\n"; // Buy a number $r = pingnum('/api/user/buy', 'POST', [ 'app_id' => $app['app_id'], 'cate_id' => $app['cate_id'], 'type' => 1, 'num' => 1 ]); if ($r['ok']) { $item = $r['data']['items'][0]; echo "Number: " . $item['tel'] . " (ID: " . $item['id'] . ")\n"; // Poll for SMS for ($i = 0; $i < 30; $i++) { sleep(5); $sms = pingnum('/api/user/sms/' . $item['id']); if (!empty($sms['sms'])) { echo "OTP: " . $sms['sms'][0]['otp_code'] . "\n"; break; } } } else { echo "Error: " . $r['msg'] . "\n"; } ?>

❓ Frequently Asked Questions

Q: How do I get an API key?

Go to Dashboard → API Access. Click Generate New Key. Copy and store the key securely.

Q: How long does the API key last?

The key is valid permanently until you regenerate it. Regenerating immediately invalidates the old key.

Q: How do I receive SMS after buying a number?

Use the item_id from the /buy response and call GET /api/user/sms/:item_id every 5–10 seconds until the SMS arrives.

Q: What is the difference between type 1, 2 and 3?

type=1 (New) — Buy a brand new number.
type=2 (Restart) — Reactivate a number that was previously used.
type=3 (Renew) — Extend the provider-level expiry of an existing number.

Q: What does "Extend session" do vs "Renew"?

Extend (/extend) — Adds 15 more minutes to your PingNum session so you can keep receiving SMS. Costs 50% of original price.
Renew (buy type=3) — Renews the number at the provider level (longer validity period). Costs full price.

Q: What to do when purchase shows "App not found or unavailable"?

The app_id may be invalid, or the number is out of stock. Call /api/user/apps to get the latest list and try a different app_id.

Q: I get HTTP 429. What should I do?

You have exceeded the rate limit. Wait for the ban to expire (usually 10–15 minutes), then reduce your request frequency. Avoid polling SMS faster than every 5 seconds.

📞 Technical Support — If you encounter any issues, contact us via Telegram Support or submit a ticket from the Support tab.

Base URL: https://pingnum.com

Request Header (All Endpoints)

Field Name	Type	Required	Description
X-Api-Key	string	Yes	Your API key from API Access settings
Content-Type	string	POST only	application/json

GET /api/user/me Account info

GET /api/user/balance Check balance

GET /api/user/apps Available numbers

POST /api/user/buy Buy a number

GET /api/user/sms/:item_id Get SMS

Field	Type	Description
item_id	int	Item ID from /buy response

POST /api/user/extend/:item_id Extend session

Field	Type	Description
item_id	int	Item ID from /buy response

GET /api/user/orders Order history

Field	Type	Required	Default	Description
limit	int	No	20	Number of records (max 100)

⚠️ Error Responses

Code	Meaning	Description
401	Unauthorized	Invalid or missing API key
400	Bad Request	Missing required field or insufficient balance
404	Not Found	Item ID not found or not yours
500	Server Error	Provider error — check msg field

All error responses: { "ok": false, "msg": "reason" }

💬 Support & Report

Need help or found a bug? We're here to assist you.

If you face any issues with recharge, SMS delivery, or transfers, please contact our support team directly via Telegram or Email. Include your User ID or Order ID for faster resolution.

✈️ Contact on Telegram

Receive SMS with
Virtual Numbers

Keep Your Number As Long As You Need

Choose a Service

Get Your Number

Receive SMS

Extend Anytime

Extendable Sessions

Instant Delivery

5 Countries

Pay Per Use Only

100% Private

Referral Rewards

Pay Only For What You Use

Start Receiving SMS in 60 Seconds

💰 Global Pricing

🔑 API Provider

📲 SMS Pool

🎁 Referral & Support

🎨 Display Options

🚫 Disable Service

Receive SMS withVirtual Numbers

Keep Your Number As Long As You Need

Choose a Service

Get Your Number

Receive SMS

Extend Anytime

Extendable Sessions

Instant Delivery

5 Countries

Pay Per Use Only

100% Private

Referral Rewards

Pay Only For What You Use

Start Receiving SMS in 60 Seconds

💰 Global Pricing

🔑 API Provider

📲 SMS Pool

🎁 Referral & Support

🎨 Display Options

🚫 Disable Service

Receive SMS with
Virtual Numbers