Voter ID Verification

Endpoint Overview

POST /api/v1/voter-id/voter-id

Description

This API endpoint allows you to verify and retrieve detailed information about a voter using their EPIC (Electors Photo Identity Card) number. The service validates the provided voter ID against official electoral records and returns comprehensive voter information including personal details, constituency information, and polling station data.

Key Benefits

Instant verification of voter identity against official electoral records

Access to comprehensive voter information including demographic and constituency details

Support for multilingual voter information with names in up to three languages

Reliable data source for KYC and identity verification processes

Use Cases

Financial Services

Government Services

Digital Platforms

KYC verification during account opening or loan applications

Address verification for credit assessment

Identity confirmation for high-value transactions

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	EPIC (Electors Photo Identity Card) Number

Example Request

{
    "id_number": "TRY1234567"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for voter information
data.client_id	String	Unique Client ID
data.input_voter_id	String	The EPIC number provided in the request
data.epic_no	String	EPIC (Electors Photo Identity Card) number
data.gender	String	Gender of the voter (e.g., "M" for Male)
data.state	String	State of residence
data.name	String	Full name of the voter
data.relation_name	String	Full name of the voter's relative
data.relation_type	String	Type of relation (e.g., "FTHR" for Father)
data.house_no	String	House number (may be null)
data.dob	String	Voter Birth Date in "YYYY-MM-DD" format (may be null)
data.age	String	Age of the voter
data.area	String	Area of residence
data.district	String	District of residence
data.additional_check	Array	Additional verification checks (if any)
data.multiple	Boolean	Indicates if multiple records were found
data.last_update	String	Last Update Date in "YYYY-MM-DD" format (may be null)
data.assembly_constituency	String	Assembly constituency name
data.assembly_constituency_number	String	Assembly constituency number
data.polling_station	String	Name of the polling station
data.part_number	String	Part number
data.part_name	String	Part name
data.slno_inpart	String	Serial number in the part
data.ps_lat_long	String	Latitude and longitude of the polling station
data.rln_name_v1	String	Relative's name in the first language
data.rln_name_v2	String	Relative's name in the second language
data.rln_name_v3	String	Relative's name in the third language
data.section_no	String	Section number
data.name_v1	String	Voter's name in the first language
data.name_v2	String	Voter's name in the second language
data.name_v3	String	Voter's name in the third language
data.parliamentary_name	String	Name of the parliamentary constituency
data.parliamentary_number	String	Parliamentary constituency number
data.st_code	String	State code
data.parliamentary_constituency	String	Parliamentary constituency name
data.id	String	Unique identifier for the record
status_code	Integer	HTTP status code
success	Boolean	Indicates if the request was successful
message	String	Additional message (may be null)
message_code	String	Message code indicating the result

Example Successful Response

{
    "data": {
        "client_id": "voter_hvTAjyKoGlubpyDctMMT",
        "input_voter_id": "TRY1234567",
        "epic_no": "TRY1234567",
        "gender": "M",
        "state": "Rajasthan",
        "name": "VISHAL",
        "relation_name": "RAJENDRA",
        "relation_type": "FTHR",
        "house_no": null,
        "dob": null,
        "age": "22",
        "area": "ABCD",
        "district": "Dausa",
        "additional_check": [],
        "multiple": false,
        "last_update": null,
        "assembly_constituency": "XXXXX",
        "assembly_constituency_number": "00",
        "polling_station": "Government Upper Primary School",
        "part_number": "000",
        "part_name": "ABCD",
        "slno_inpart": "000",
        "ps_lat_long": "",
        "rln_name_v1": "राजेंद्र",
        "rln_name_v2": "",
        "rln_name_v3": "",
        "section_no": "2",
        "name_v1": "विशाल",
        "name_v2": "विशाल",
        "name_v3": "",
        "parliamentary_name": "ABCD",
        "parliamentary_number": "11",
        "st_code": "S20",
        "parliamentary_constituency": "Dausa",
        "id": "6940610_TRY1234567_S20"
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid Voter ID

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

The provided PAN number does not match the required format or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API keys and tokens securely, never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Implement rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Provide clear instructions for users when entering their EPIC number

Implement proper validation for the EPIC number format before making API calls

Display a user-friendly error message when verification fails

Consider implementing a fallback verification method if voter ID verification fails

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify PAN card details for identity verification

Aadhaar Verification API: Verify Aadhaar card details for identity verification

Address Verification API: Verify address details against multiple data sources

Document OCR API: Extract information from identity documents automatically

Compliance and Legal Considerations

When using this API, ensure compliance with the Election Commission of India's data usage policies. The voter information should only be used for legitimate verification purposes with appropriate user consent. Personal data obtained through this API must be handled in accordance with applicable privacy laws and regulations, including but not limited to the Information Technology Act, 2000 and any future data protection laws in India.

{ "data": { "client_id": "voter_hvTAjyKoGlubpyDctMMT", "input_voter_id": "TRY1234567", "epic_no": "TRY1234567", "gender": "M", "state": "Rajasthan", "name": "VISHAL", "relation_name": "RAJENDRA", "relation_type": "FTHR", "house_no": null, "dob": null, "age": "22", "area": "ABCD", "district": "Dausa", "additional_check": [], "multiple": false, "last_update": null, "assembly_constituency": "XXXXX", "assembly_constituency_number": "00", "polling_station": "Government Upper Primary School", "part_number": "000", "part_name": "ABCD", "slno_inpart": "000", "ps_lat_long": "", "rln_name_v1": "राजेंद्र", "rln_name_v2": "", "rln_name_v3": "", "section_no": "2", "name_v1": "विशाल", "name_v2": "विशाल", "name_v3": "", "parliamentary_name": "ABCD", "parliamentary_number": "11", "st_code": "S20", "parliamentary_constituency": "Dausa", "id": "6940610_TRY1234567_S20" }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Voter ID

Voter ID Verification#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses