Nonchalant Guidance

About Me·RSS·My Projects·LinkedIn

Added on: Wednesday, 10 August, 2022 | Updated on: Thursday, 02 March, 2023

Phone Number Look-ups

An unexpected way to extract name from phone numbers in India

I, like many people, am very bothered with spam calls. These unwanted callers telling me about a loan deal going on or a great credit card that gives me enough points to go to space with a billionaire. I couldn’t care less about these. I also don’t appreciate the spam text messages as well, and they can often contain links to spams.

Now, in India, there is a Do Not Disturb list from TRAI, the telecom regulator, which can be activated by going to your carrier’s website/app and selecting the right option. See this help article for Reliance Jio, this page to activate DND for Vi, and this page for Airtel. While this option does seem to lessen the spam, there are still a couple callers which do not obey this setting. It is best to just report those to TRAI using the DND app, available on the iOS App Store and Google Play Store.

This will prevent most large-scale spammers, but will not stop a smaller operation or even scammers who will just keep calling. Also, it doesn’t help prevent other misuses of telecom networks, like being harassed over the phone, etc. (There are also less mild examples of caller ID being needed) If only you could just find whose phone number that was!

(Alas, caller ID standards implemented in the telecom space just have never been adopted for some reason).

Except, of course there’s a solution™. Let caller ID apps like Truecaller have access to your contacts, phone records, and text messages, and they will stop the spam and tell you who called you!

This is, in my opinion, a bad solution. These apps don’t have good privacy policies, and have too many people giving their phone records to a private company. India doesn’t have a data protection law either right now, and it is worrying to think what will happen if they are compromised.

(By the way, if you want to unlist your number from Truecaller, go to this link).

So, what is the real solution? Is there no real way to get caller ID working in the age of information for a common man?

The Real(-ish) Solution

Some background

United Payments Interface, or UPI for short, is a revolutionary payment system devised by the National Payments Corporation of India, which allows users to just use a smartphone app to transfer money directly and instantly from their bank account to any other bank account, simply by entering a Virtual Private Address, or VPA, (which resembles an email address: think prefix@suffix), phone number, or the traditional bank account number + IFSC. Merchants typically have a QR code prominently displayed in their establishments so consumers can easily scan it within their UPI apps and pay easily.

This was a paradigm shift for a country that had predominantly used cash, and thanks to the ultra low prices of smartphones and 4G phone plans, it took off like crazy. What is even more extraordinary is that there are no transaction fees levied on consumers, so anyone from roadside vendors, small shopkeepers, and technology-averse friends and family can all easily use it to send and receive money.

There are also many UPI apps, from the ones that your bank has to external ones (like PayTM or PhonePe) to BHIM, which can be thought of as the reference implementation, maintained by the NPCI. You can use any of these, send money to anyone using any other app etc. It is truly an example of federation done right (though can it be federated when there is one organization being in-charge of everything?)

Okay, so this is great, but why does this matter?

Why it Matters

Well, the default VPA of many apps is simply the customer’s phone number + @ + a suitable suffix (this usually correlates to the app or bank that the customer is using: “paytm” for PayTM, anything beginning in “wa” is WhatsApp Pay, anything beginning in “ok” is Google Pay, “upi” is BHIM, etc).

Also, whenever you enter a phone number for paying in a UPI app, there is an option given to “verify” that number. Upon clicking on it, it usually returns the name associated with that phone number in the UPI system.

Adding these two facts together, could it be possible to simply do a brute force search until we find a name?

This approach does have certain niceties about it:

There are other downsides though:

Of course, why are we even discussing this?

This can’t be possible, right? I mean, a brute force search on a somewhat sensitive network (a payments system) shouldn’t be possible?

Brute Forcing It (but smartly)

I did find a website which allows you to make such requests: you simply pass it a VPA and it returns you whether there is a UPI account that exists with that VPA, and if so, the name of the account holder.

This website,, has no real info about it. The API documentation consists of a single page PDF, there is no privacy policy, and according to their home page, they exist so that you don’t have to pay Rs 2 from the big guys for validating a VPA. It is a fairly shady website. However, compared to the information Truecaller takes, there is almost nothing of value being given back to this website other than maybe your IP address.

No authentication is really required, and as far as I can tell in my testing, there doesn’t seem to be a rate limit either (I am sure there is one, I just haven’t hit it yet).

Nonetheless, I wanted to make the experience better for the user. The tool that inspired my journey into this name via UPI method (found here, thanks Aseem Shrey!) did an exhaustive search alphabetically, using 128 possible VPAs!. Most of these are just small banks and, statistically speaking, it makes more sense to check the most popular apps first. In fact, many searches can be completed just by checking the most popular VPAs.

So, I filtered out most of the VPAs from the list from the upi-recon-cli project to only include the handful that have dominated the UPI market, which include but are not limited to:

Edit: This will likely be removed since it is a fairly useless check, see above edits for info

I wanted to keep a balance between covering enough apps that someone shouldn’t have to resort to running an intensive scan but still make the default option fast enough so that someone doesn’t feel impatient.


I wrote a small shell script as a proof of concept (available here) and implemented this behaviour. It pretty much just reads the suffix file (by default a popular collection I created, but it can also do the alphabetical brute search of 128 addresses as well with another option), queries upibankvalidator if that VPA exists, and if it does, just return the name of the account holder and exits.

I used httpie, which was a bit easier to work with than cURL in my experience, and jq to parse the JSON response easily.

This is really only meant for testing purposes, and I do want to build a better front end so that other people can use it.

Nevertheless, I decided to release the small CLI I created so that usage numbers can stay low, and the service can still stay online (how it is still staying online as a completely free API with no real monetization plans visible, I have no idea). Please use the service with care. I assume no liabilities, and am not associated in any way with the website.


Overall, we see that there is a pretty nice loophole to find phone numbers by using a peculiar property of UPI payments system and a very generous, free API. I hope you found this deep dive useful, and the tool as well.

That’s all for today. Bye for now!

This website was made using Markdown, Pandoc, and a custom program to automatically add headers and footers (including this one) to any document that’s published here.

Copyright © 2023 Saksham Mittal. All rights reserved. Unless otherwise stated, all content on this website is licensed under the CC BY-SA 4.0 International License