🔐 Authentication
All requests require an API key as a GET parameter:
?apiKey=YOUR_KEY🧱 API Endpoints
GET /getCountries
Returns a list of supported countries available for number purchase.
https://tgpva.com/api/user/getCountries?apiKey=YOUR_KEYGET /getBalance
Returns the remaining credit available for your account.
https://tgpva.com/api/user/getBalance?apiKey=YOUR_KEYGET /getNumber
Returns a temporary phone number for a given country.
https://tgpva.com/api/user/getNumber?apiKey=YOUR_KEY&country=USGET /getCode
Fetches the verification code received on the given phone number and session hash.
https://tgpva.com/api/user/getCode?apiKey=YOUR_KEY&number=%2B123456789&hash=xyz123✅ Example Response
Successful balance response:
{
"ok": true,
"msg": "success",
"result": { "balance": "42.5" }
}❌ Error Responses
- ❌
Invalid API key– Your API key is not recognized - ⚠️
Parameter "..." is required– A required GET parameter is missing - ❌
Invalid phone number format– Phone number format is invalid - ⚠️
Failed to fetch ...– The system could not fetch external data