EWS Certificate Verification

This document describes state-wise inputs required to verify EWS certificates via this service, and how to obtain captcha where applicable.

EWS Certificate Structure

Key	Description
EWS Number	Unique EWS/Certificate/Application number
Name	Applicant name (only for specific states)
Security Code	Security code printed on certificate (Kerala)
Captcha	Captcha text solved for the verification
Token	Anti-forgery/request token (Delhi only), found in captcha response

State-wise requirements (serial)

The following states are currently supported:

State	Code	Requires Name	Requires Captcha	Requires Token	Requires Security Code	Number Format (masked)
Andhra Pradesh	AP	No	No	No	No	CGCXXXXXXXXXXXX (15)
Bihar	BR	Yes	No	No	No	EWSCO/XXXX/XXXXXX (17)
Chhattisgarh	CT	No	No	No	No	XXXXXXXXXXXXXXXX[X] (16–17)
Delhi	DL	Yes	Yes	Yes	No	XXXXXXXXXXXXXX (14)
Haryana	HR	No	No	No	No	HAXXXXXXXXXX (12)
Kerala	KL	No	No	No	Yes	XXXXXXXX (8)
Odisha	OR	No	No	No	No	XXXXXXXX (8)
Punjab	PB	No	No	No	No	ESXXXXXXXX (10)
Rajasthan	RJ	No	No	No	No	XXXXXXXXXXXX (12)
Tamil Nadu	TN	No	Yes	No	No	TN-XXXXXXXXXXXXXX (16)
Telangana	TG	No	No	No	No	CNDXXXXXXXXXXXXXXX (15)

API Integration

• Endpoint to get captcha (if required by state):

  • POST /ews-certificate/pre

• Endpoint to verify and fetch certificate details (send captcha answer if required):

  • POST /ews-certificate

Captcha fetch (DL, TN)

Request:

{
  "state": "DL"
}

Response:

{
  "captcha": "<base64 image>",
  "token": "<anti-forgery token if required>"
}

Verify request examples

• Delhi (requires name + captcha + token):

{
  "state": "DL",
  "ewsNumber": "XXXXXXXXXXXXXX",
  "name": "JOHN",
  "captcha": "7h2joU",
  "token": "<token-from-captcha-api>"
}

• Bihar (requires name):

{
  "state": "BR",
  "ewsNumber": "EWSCO/XXXX/XXXXXX",
  "name": "JOHN DOE"
}

• Kerala (requires securityCode):

{
  "state": "KL",
  "ewsNumber": "XXXXXXXX",
  "securityCode": "3RMPZ"
}

• Tamil Nadu (requires captcha):

{
  "state": "TN",
  "ewsNumber": "TN-XXXXXXXXXXXXXX",
  "captcha": "A1B2C3"
}

• States with only number (examples: AP, CT, HR, OR, PB, RJ, TG):

{
  "state": "AP",
  "ewsNumber": "CGCXXXXXXXXXXXX"
}

Successful Response (example)

{
  "code": 0,
  "message": "Success",
  "data": {
    "certificateNumber": "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"
  }
}

Invalid/Not found Response (example)

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