Voter ID Verification

Endpoint Overview

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

Description

This API endpoint allows you to verify and retrieve detailed information associated with an Indian Voter ID (EPIC - Elector's Photo Identity Card). The service validates the provided ID number against official electoral records and returns comprehensive voter information including personal details, address information, and electoral data.

Key Benefits

Instant verification of Voter ID authenticity against official records

Access to comprehensive voter details including name, age, gender, and address

Reduce fraud by confirming the legitimacy of submitted voter identification

Streamline KYC processes with reliable government-issued ID verification

Use Cases

Financial Services

Government Services

Digital Platforms

Customer onboarding and KYC verification for banking and financial institutions

Identity verification for loan and credit card applications

Fraud prevention during account opening processes

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. Format: `Bearer {your_jwt_token}`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	The EPIC (Voter ID) number to verify. Format should match the standard Voter ID format.
additional_details	Object	No	Optional object containing additional information to enhance verification accuracy.
additional_details.full_name	String	No	Full name of the voter for additional verification.
additional_details.dob	String	No	Date of birth in YYYY-MM-DD format for additional verification.

Example Request

{
    "id_number": "NLN2089555",
    "additional_details": {
        "full_name": "Karan Kapoor",
        "dob": "1996-02-29"
    }
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verified voter information
data.relation_type	String	Type of relation (F for Father, M for Mother, etc.)
data.gender	String	Gender of the voter (M for Male, F for Female, O for Other)
data.age	String	Age of the voter
data.epic_no	String	EPIC (Voter ID) number
data.client_id	String	Unique client identifier
data.dob	String	Date of birth in YYYY-MM-DD format
data.relation_name	String	Name of the relation (father/mother/guardian)
data.name	String	Full name of the voter
data.area	String	Residential area/locality
data.state	String	State of residence
data.house_no	String	House number or identifier
status_code	Integer	HTTP status code of the response
message	String	Additional information or error message
success	Boolean	Indicates whether the request was successful

Example Successful Response

{
    "data": {
        "relation_type": "F",
        "gender": "M",
        "age": "29",
        "epic_no": "NLN2089555",
        "client_id": "bkpkzGyssQ",
        "dob": "1990-08-31",
        "relation_name": "KALEEN BHAIYA",
        "name": "MUNNA BHAIYA",
        "area": "Mirzapur",
        "state": "Uttar Pradesh",
        "house_no": "Tripathi Haveli"
    },
    "status_code": 200,
    "message": "",
    "success": true
}

Possible Error Responses

Invalid ID

ID Not Found

Authentication Error

{
    "data": null,
    "status_code": 400,
    "message": "Invalid Voter ID format or number",
    "success": false
}

The provided Voter ID number is invalid or does not match the required format.

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 error messages to users when verification fails

Implement a retry mechanism with guidance on correct ID format

Consider implementing progressive disclosure of verification results

Cache verification results (where legally permitted) to improve performance

Code Samples

cURL

Python

Node.js

Related APIs

PAN Card Verification API: Verify PAN card details against government records

Aadhaar Verification API: Verify Aadhaar card details with OTP authentication

Driving License Verification API: Verify driving license details against RTO records

Address Verification API: Verify residential address details against multiple sources

Compliance and Legal Considerations

This API handles personally identifiable information (PII) and is subject to data protection regulations. Ensure you have proper consent from users before verifying their Voter ID information. Usage of this API must comply with the Election Commission of India's regulations and applicable data protection laws including the Personal Data Protection Bill. Store verification results securely and only for the duration necessary for your business purpose.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/voter-id/voter-id' \ --header 'X-Customer-Id: {{customer_id}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "{{epic_number}}", "additional_details": { "full_name": "Karan Kapoor", "dob": "1996-02-29" } }'

{ "data": { "relation_type": "F", "gender": "M", "age": "29", "epic_no": "NLN2089555", "client_id": "bkpkzGyssQ", "dob": "1990-08-31", "relation_name": "KALEEN BHAIYA", "name": "MUNNA BHAIYA", "area": "Mirzapur", "state": "Uttar Pradesh", "house_no": "Tripathi Haveli" }, "status_code": 200, "message": "", "success": true }

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