PAN verification API: check a PAN and match the holder name

GET /v1/pan/{pan}/verify tells you whether a PAN exists and returns the name registered against it. Send the name you hold as well and it says whether the two match, ignoring titles like Mr and M/S and suffixes like Pvt Ltd. Ask for more depth and you also get date of birth, holder category and whether an Aadhaar is linked. It costs from 4 credits a PAN, and nothing is stored.

Free sample with the test PAN AAAAA0000A, no credit used. Live calls need an account that has bought a credit pack.

Three levels, one endpoint

Choose how much you need with the level parameter. The default is basic.

LevelWhat comes backScale or Business packStarter pack
basicWhether the PAN exists, its status and the registered holder name4 credits6 credits
verifiedBasic, plus date of birth, holder category and whether an Aadhaar is linked6 credits10 credits
detailsVerified, plus address and contact details and employment type, as the source returns them12 credits18 credits

Matching a name against the PAN

Add the name query parameter and the response carries name_match, a score from 0 to 100 and a matched flag, true at 80 or more. The comparison works on words, not exact text: titles such as Mr, Mrs and Shri and company suffixes such as Pvt Ltd and Limited are ignored, word order does not matter, and a single initial matches a full first name, so R Kumar Shah matches Ramesh Kumar Shah.

It is a hint for your own decision, not a legal identity check. A missing middle name is a partial match and can fall below the threshold, so decide what score your process accepts.

A request and a response

GET /v1/pan/AAPFU0939F/verify?level=basic&name=Ramesh%20Kumar%20Shah with your key in the x-api-key header returns the registered name, the PAN status and the match result.

FieldExampleLevel
verifiedtrueall
nameRAMESH KUMAR SHAHall
name_match{ "score": 100, "matched": true }all, when name is sent
statusActivebasic
dob06/01/1994 (DD/MM/YYYY)verified
categoryIndividualverified
aadhaar_linkedtrueverified

What it costs

PAN verification spends the same credits as the rest of gstinapi.in, at a rate set by the best pack your account has ever bought. In rupees, before 18% GST, that is:

  • A PAN with no record is charged, because the lookup was made, and the response says so.
  • A malformed PAN, a value the source rejects and any failure on our side or the source’s cost nothing.
  • Credits are shared with GSTIN lookups and never expire.
LevelScale packBusiness packStarter pack
basic₹1.60₹2.00₹4.80
verified₹2.40₹3.00₹8.00
details₹4.80₹6.00₹14.40

What it does and does not do

  • It checks a PAN and returns the registered name. It does not confirm that the person in front of you owns that PAN: that needs your own identity check.
  • The masked Aadhaar number is never returned, only whether one is linked.
  • Nothing is cached. Each call asks the source, and the answer is not kept beyond a usage log of the PAN, status and time.
  • Date of birth, address and contact are personal data. Use them for the purpose you looked them up for, and make sure you have the right to verify the PAN you submit.
  • To find the GSTINs a PAN holds, use the PAN to GSTIN search instead; this endpoint is about the person or firm behind the PAN.

Frequently asked questions

Is there an API to verify a PAN and get the name?

Yes. GET /v1/pan/{pan}/verify returns the holder name registered against a PAN, and with the name parameter it says whether the name you hold matches. It costs from 4 credits a PAN, and you can try it free with the test PAN AAAAA0000A.

How much does PAN verification cost?

Basic, the registered name, is 4 credits on the Scale or Business pack and 6 on Starter, which is ₹1.60, ₹2.00 and ₹4.80 before GST. Verified, which adds date of birth and Aadhaar-link status, is 6 or 10 credits. Details is 12 or 18 credits.

Can the API check whether a name matches a PAN?

Yes. Send the name you hold in the name parameter and the response includes name_match with a score from 0 to 100. Titles, company suffixes and word order are ignored and an initial matches a full first name. A score of 80 or more is reported as matched.

Does it return the Aadhaar number?

No. At the verified and details levels it tells you whether an Aadhaar is linked to the PAN, and the masked Aadhaar number is never returned.

Is a PAN with no record charged?

Yes, because the lookup was made and the answer is that no such PAN is on record. A malformed PAN, a value the source rejects and an outage are free.

Is PAN verification the same as PAN to GSTIN search?

No. PAN verification tells you who a PAN belongs to. PAN to GSTIN search finds the GST registrations held under a PAN across all 36 state codes. They are billed separately.

Do I need a paid account?

Live calls need an account that has bought a credit pack. Any account can build and test against the sample PAN AAAAA0000A, which returns a fixed result in the live shape and uses no credit.

Start with up to 75 free lookups

10 on signup and 65 more across three setup steps. No card, and they never expire.

Create a free account