/verify/indian_voter

1.API Specification
2.Request Params
3.Response Params
4.Error Codes
5.Sample

1.API Specification

This API is used to verify Indian voterid.

Request Method

POST

Request URL

https://cloudapi.accuauth.in/verify/indian_voter

Debugging Tool

Debugging Tool

2.Request Params

2.1 Request Header

Parameter Type Required Description
X-DF-API-ID string Yes For API credentials，Please visit API Request
X-DF-API-SECRET string Yes For API credentials，Please visit API Request

2.2 Request Body

Required Fields Type Description
required epic_no string EPIC Voter ID number
optional consent string Y or N, default Y
optional consent_text string Consent message

3.Response Params

Fields Type Description
request_id string Unique id of each request
status string Response status, OK for success request, Error Codes for failed request
result_code integer Result code, see Result Codes for detail
result_message string Result message
result object The verfication result

3.1 Elements in result

Fields Type Description
id string Unique ID of the card holder [st_code+ ac_no + section_no + slno_inpart]
name string Name of the card holder in English
name_v1/2/3 string Card holder’s name in vernacular language
dob string Date of Birth of the Voter Card holder as per EPIC records
gender string Gender of the card holder
age string Age of the card holder in Years
rln_name string Name of relative in English
rln_name_v1/2/3 string Name of relative in vernacular language
rln_type string Relationship type : "F" = Father, "H" = Husband
house_no string House number of the residence of the card holder
part_no string Name of the part (Location) in the constituency applicable to the card holder
part_name string Name of the part (Location) in the constituency applicable to the card holder
section_no string Section of the constituency part applicable to the card holder
epic_no string EPIC Voter ID number to be authenticated
last_update string Last date of update to the records against the given epic_no in Government Records
st_code string State Code
state string State of the registered Electoral Office
district string District of the Electoral Office
ac_no string Assembly Constituency No applicable to the card holder
ac_name string Assembly Constituency applicable to the card holder
ps_name string Polling Booth Address applicable for the card holder
ps_lat_long string Lat Long for the polling booth applicable to the card holder
pc_name string Parliamentary Constituency applicable to the card holder
slno_inpart string Serial number of the card holder in the polling list in the applicable part

3.2 Result Code Description

Value Description Billable
101 Valid authentication Yes
102 Invalid ID number or combination of inputs Yes
103 No records found for the given ID or combination of inputs Yes
104 Max retries exceeded Yes
105 Missing Consent Yes
106 Multiple Records Found Yes
Response Syntax
{
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
  "status": "OK",
  "result": {
    "ps_lat_long": "***",
    "rln_name_v1": "***"
    "rln_name_v2": "",
    "rln_name_v3": "",
    "part_no": "52",
    "rln_type": "F",
    "section_no": "1",
    "id": "NRB0399436",
    "epic_no": "NRB0399436",
    "rln_name": "Naresh Talwar",
    "district": "Dehradun",
    "last_update": "",
    "state": "Uttarakhand",
    "ac_no": "67",
    "house_no": "278A",
    "ps_name": "",
    "pc_name": "Tehri Garhwal",
    "slno_inpart": "312",
    "name": "Mohak Talwar",
    "part_name": "VikasnagarWest Part R.No.3",
    "dob": "",
    "gender": "M",
    "age": 23,
    "ac_name": "Chandrayangutta",
    "name_v1": "मोहक तलवाल",
    "st_code": "S28",
    "name_v3": "",
    "name_v2": ""
  },
}

4.Error Codes

Common error codes of this API:

Http Status Code Status Field Description
400 INVALID_ARGUMENT Request parameter is invalid
400 QUERY_FAILED Query failed
400 ABNORMAL_BEHAVIOURS_DETECTED Request with same parameters repeated more than amount of times
401 UNAUTHORIZED Unauthorized or access is denied
401 KEY_EXPIRED Your API ID has expired
403 NO_PERMISSION You are not authorized to use this API
403 OUT_OF_QUOTA API calls quota exceeded
403 RATE_LIMIT_EXCEEDED API request frequency exceeds the limit
404 NOT_FOUND Requested API cannot be found
500 INTERNAL_ERROR Internal server error
512 SOURCE_SERVICE_UNAVAILABLE Source service is unavailable
513 SOURCE_SERVICE_TIMEOUT Source service is timeout

Comment: Please see the reason field for details when the above 40X / 51X error occurred

Response Syntax
{
  "status": "INVALID_ARGUMENT",
  "reason": "argument 'epic_no': not found",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.Sample

results matching ""

    No results matching ""