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 Captcha EWS 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"
  }
}