Request Method :: POST

Description: The Voter ID Verification API verifies the authenticity of a voter ID.

Headers

---

Content-Type: application/JSON

header_secrets:  To be shared during integration by ISU Team

pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters	Parameter description with validations and examples	Data type	Mandatory/Optional
epicNumber	The unique voter ID number to be verified. E.g. - "IIM1068089"	String	Mandatory
getAdditionalData	Specifies whether to fetch additional voter details. E.g. - "true" or “false”	boolean	Mandatory

Sample Request Body

---

{ "epicNumber": "IIM1068089", "getAdditionalData": "true" }

Encrypted Sample Request Body

---

{ "RequestData": " Px9KGUbtZmAhMrdZLeRhj6n150cB1ZSqChVHdmk8hMDztsHt35BSjUP0BPNrTbIvpaiw2trZLaerEsGs4e uuRgvQvL4olJIssbdiKGaEDR0=" }

Response Body Parameters

Parameters	Parameter description with examples	Data type
status	Indicates the result of the request	String
statuscode	Code representing the status	integer
status_des	Detailed message about the status	string
Data	Contains the response data	Object
result	Contains voter details	Object
name	Full name of the voter	String
nameInRegionalLang	Name in regional language	String
age	Age of the voter	String
relationType	Type of relation (e.g., Father, Mother)	String
relationName	Name of the relation	String
relationNameInRegionalLang	Relation name in regional language	string
fatherName	Name of the father	string
dob	Date of Birth	String
gender	Gender of the voter	string
address	Full address of the voter	String
splitAddress	Contains detailed address breakdown	Object
district	District of the voter	String
state	State of the voter	String
city	City name	String
pincode	Pincode of the area	String
country	Country details	String
addressLine	Address Line	String
epicNumber	Voter ID number	String
assemblyConstituencyNo	Assembly Constituency Number	String
assemblyConstituency	Assembly Constituency Name	String
parliamentaryConstituencyNo	Parliamentary Constituency Number	String
parliamentaryConstituency	Parliamentary Constituency Name	String
partNo	Part number	string
partName	Part name	string
serialNo	Serial number of the voter	String
pollingStation	Name of the polling station	String
photo	photo of the voter	String
error	Name of the error (Only for FAILED)	String
type	Type of error (Only for FAILED)	string
value	The actual value that caused the error (Only for FAILED)	string
message	Error message (Only for FAILED)	string
path	The field in the request body where the error occurred (Only for FAILED)	string
location	Location in the request where the issue was found (e.g., body) (Only for FAILED)	string

Sample Response Body

---

SUCCESS:

{ "status":"success”, "statuscode": 0, "status_desc": "voter verified successfully", "data": { "result": { "name": "PRATYUSH KUMAR SETHY", "nameInRegionalLang": "୍ରେତ୍ ୟୁଶ କୁମାର ସେଠୀ", "age": "25", "relationType": "FTHR", "relationName": "PREMANANDA", "relationNameInRegionalLang": "ସ୍ରେମାନନ୍ଦ ସେଠୀ", "fatherName": "PREMANANDA SETHY", "dob": "", "gender": "Male", "address": "GOVT U.P SCHOOL JIRAL", "splitAddress": { "district": [ "Dhenkanal" ], "state": [ [ "ODISHA" ] ], "city": [ "KAMAKHYANAGAR" ], "pincode": "", "country": [ "IN", "IND", "INDIA" ], "addressLine": "GOVT U.P SCHOOL JIRAL" }, "epicNumber": "IIM1068089", "state": "ODISHA", "assemblyConstituencyNo": "57", "assemblyConstituency": "KAMAKHYANAGAR", "parliamentaryConstituencyNo": "9", "parliamentaryConstituency": "DHENKANAL", "partNo": "70", "partName": "JIRAL-4", "serialNo": "362", "pollingStation": "GOVT U.P SCHOOL JIRAL", "photo": "" } } }

 

FAILED:

voter verification error:

{ "status": "failed", "statuscode": 1, "status_desc": "voter verification failed" “data” : {} }

epicNumber and getAdditionalData not provided:

{ "status": "Failed", "statuscode": 2, "status_desc": "invalid input for epicNumber, getAdditionalData" ,"data": [ { "type": "field", "value": " ", "msg": "Voter ID must be between 5 and 15 characters", "path": "epicNumber", "location": "body" }, { "type": "field", "value": " ", "msg": "isActive must be a boolean value", { "path": "getAdditionalData", "location": "body" } ] }

invalid epicNumber input and getAdditionalData not provided:

{ "status": "Failed", "statuscode": 2, "status_desc": "invalid input for epicNumber, getAdditionalData", "data": [ { "type": "field", "value": "iuygesdf45678 ", "msg": "Voter ID must be uppercase alphanumeric", "path": "epicNumber", "location": "body" }, { "type": "field", "value": " ", "msg": "isActive must be a boolean value", "path": "getAdditionalData", "location": "body" } ] }

Encrypted Sample Response Body

---

{ "ResponseData": "DNDi31FL42cBXXFW4lfFN0FAPibmJn+jR7IZtnLSSGJ0wR/ B48Yw50uV4pY03Mnen+Aml1x2SigckgL1MKH/ 4EQgNd3R+7yOA8YIGFJlPILHumfLicUJBpxHCKniRbSgLuhv2ljxx73MjPvOm0gDTipUQRlDfSCfPZlq8i57i Ws8JwZtEdXUFOSKNyg==" }

Status Codes

Status	Status Code	Description
SUCCESS	0	voter verified successfully
FAILED	1	voter verification failed
Validation error	2	Voter ID must be between 5 and 15 characters Voter ID must be uppercase alphanumeric isActive must be a boolean value