Voter Card Verification API
Verify Voter ID (EPIC Number) details directly against National Voters Service Portal (NVSP) database. Returns voter full name, gender, assembly constituency, and state.
POST /api/v1/verify_votercard
~<500ms Avg Latency
99.9% Uptime SLA
x-api-key Auth
API Overview
Validate Voter ID (EPIC Number), voter name, gender, and state location.
Key Features & Data Points:
- Instant Authoritative Response: Fetches verified official data with ultra-low response latency (~<500ms).
- Clean JSON Standard: Normalized structure across all verification services for effortless enterprise integration.
- Enterprise SLA: Backed by NextStepApi 99.9% uptime architecture and redundant provider failover.
- Secure Header Authentication: Direct authentication via
x-api-keyrequest header.
Request Specification
Headers:
| Header Name | Type | Description |
|---|---|---|
| x-api-key* | string | Your secret production API Key obtained from your NextStepApi dashboard. |
| Content-Type* | string | Must be set to application/json. |
| x-request-id | string | Optional client-generated tracking ID (e.g. REQ12345XYZ) for idempotent logging. |
Request Body (JSON):
| Parameter | Type | Description |
|---|---|---|
| voter_id* | string | Elector's Photo Identity Card (EPIC) voter ID number. |
Request & Response Examples
Sample Request:
HTTP POST /api/v1/verify_votercard
POST /api/v1/verify_votercard
x-api-key: your_api_key_here
Content-Type: application/json
{
"voter_id": "ABC1234567"
}
Sample Response (200 OK — Sanitized Test Data):
HTTP 200 OK • application/json • <500ms
{
"code": 200,
"status": "success",
"message": "Success",
"request_id": "REQ12345",
"response": {
"request_id": "REQ12345",
"epic_no": "ABC1234567",
"holder_name": "ROHIT SHARMA",
"dob": "01-01-1990",
"gender": "MALE",
"age": "34",
"relation": "RAMESH SHARMA",
"relation_type": "FATHER",
"area": "NEW DELHI",
"district": "NEW DELHI",
"assembly_constituency": "NEW DELHI",
"parliamentary_constituency": "NEW DELHI",
"polling_station": "GOVT SCHOOL",
"part_number": "12",
"part_name": "PART 1",
"id": "123456"
}
}
Business Use Cases
1
Address & Identity Verification
Designed for mission-critical workflows requiring verified real-time data lookups.
2
Rural KYC Onboarding
Designed for mission-critical workflows requiring verified real-time data lookups.
3
Government Benefit Scheme
Designed for mission-critical workflows requiring verified real-time data lookups.
4
Customer Onboarding
Designed for mission-critical workflows requiring verified real-time data lookups.
Integration Steps
1
1. Pass EPIC Number (e.g. ABC1234567)
2
2. POST call to /api/v1/verify_votercard
3