Account recovery
Reset a password with the account email, then sign in again before investigating balance, history, or API keys.
Support
Resolve a TG Validator account or API issue
Start with the error code or affected workflow, follow the recommended check, and contact support only when the documented next step does not resolve it.
Reset your password
API request reference
Confirm the X-API-Key header, E.164 identifier, service_type=tg, response envelope, and published error codes.
Payments and balance
Compare credited balance, check counts, payment methods, and the automatic refund rule before opening a payment enquiry.
Error guide
What should you do for each API error?
Use the HTTP status and response code together. Remove secrets before sharing a response with support.
| Status / code | Meaning | Next action |
|---|---|---|
| 401 / 40100 | The API key is missing or invalid. | Send X-API-Key, confirm you copied the active key, and create a replacement in Settings if the original is unavailable. |
| 402 / 40200 | The account does not have enough balance for a Telegram check. | Check the current price and balance, then complete a top-up before retrying the same request. |
| 429 / 42900 | The account or demo exceeded a published rate limit. | Stop immediate retries, wait before sending another request, and keep automated calls within the documented per-user limit. |
| 503 / 50300 | The validation service is temporarily unavailable or in maintenance. | Do not classify the number as unregistered. Retry later; failed or undetermined checks do not keep the charge. |
Before contacting support
Include the details that identify the request
Useful context shortens investigation time without requiring passwords or API key values.
- AccountThe email associated with the workspace.
- RequestThe transaction ID, service type, and approximate request time.
- ResponseThe API error code and message, with secrets removed.
Faster support checklist
Most account and API issues can be resolved faster when your message includes account email, service_type, request time, and a redacted response body.
Contact: support@tgvalidator.com