EWS Certificate Verification

Tax Deduction and Collection Account Number (TAN) is a ten-digit alphanumeric identifier issued by the Income Tax Department of India. It is mandatory for individuals and businesses required to deduct or collect tax at source.

EWS Certificate Structure

Key	Description
EWS Number	Unique number of ews Certificate
Name	Individual Name of the Certificate
Security Code	Certificate Security code(Applicable for kerala state)

API Integration

EWS Certificate verification can be performed directly using the Verify EWS API

API For captcha

Generate captcha and token(If required) using the Generate Captcha Api

Captcha Request

For the TAN is valid

{
  "state": "DL"
}

Captcha Response

For Valid state

{
  "captcha": "Base 64 Image string"
  "token": "XXXXXXXXXXXXXXXX" // Token string if required in the state
}

Request

{
   "state": "DL", //State Code
   "ewsNumber": "909XXXXXXX70", // EWS certificate Number
   "name": "XXXXXXXX", // Name of candidate
   "captcha": "7h2joU", // Captcha string get using captcha api(optional)
   "token": "XXXXXXXXXXXX" // Token string get using captcha api(optional)
}

Response

If the Ews Certificate is valid

{
  "code": 0,
  "message": "Success",
  "data": {
    "applicationNumber": "XXXXXX",
    "name": "RXXXX XXXXXA",
    "fatherName": "JUXXXL XXXXR SXXXXA",
    "motherName": "SXXXN XXXI",
    "village": "XXXXXXX",
    "mandal": "XXXXXXXXX",
    "district": "JXXXXXXXXXX",
    "cast": "BXXXXXXX",
    "income": "1XXX",
    "address": "XXXXX  XXXXX XXXx",
    "age": "XX",
    "gramPanchayat": "XXXXXXXXX",
    "pinCode": "XXXXXX",
    "aadharId": "XXXXXXX"
  }
}

If the Ews Certificate is invalid

{
  "code": 0,
  "message": "Success",
  "data": {
    "status": "INVALID",
    "message": "Invalid EWS Certificate"
  }
}

Parameters

• state (string): Code for state:- (Required)

1. AN = Andaman and Nicobar Islands
2. AP = Andhra Pradesh
3. AR = Arunachal Pradesh
4. AS = Assam
5. BR = Bihar
6. CH = Chandigarh
7. CT = Chhattisgarh
8. DN = Dadra and Nagar Haveli
9. DD = Daman and Diu
10. DL = Delhi
11. GA = Goa
12. GJ = Gujarat
13. HR = Haryana
14. HP = Himachal Pradesh
15. JK = Jammu and Kashmir
16. JH = Jharkhand
17. KA = Karnataka
18. KL = Kerala
19. LA = Ladakh
20. LD = Lakshadweep
21. MP = Madhya Pradesh
22. MH = Maharashtra
23. MN = Manipur
24. ML = Meghalaya
25. MZ = Mizoram
26. NL = Nagaland
27. OR = Odisha
28. PY = Puducherry
29. PB = Punjab
30. RJ = Rajasthan
31. SK = Sikkim
32. TN = Tamil Nadu
33. TG = Telangana
34. TR = Tripura
35. UP = Uttar Pradesh
36. UT = Uttarakhand
37. WB = West Bengal