BrandKwikID Documentation
API SuiteVoter ID Verification

V3

Performs Voter ID card EPIC details verification via KwikID.

Voter ID Verification (V3)

API reference

Try itLoading playground…
Loading…
AuthorizationBearer <token>

JWT Bearer token authentication. Obtain a token from the KwikID dashboard.

In: header

epicNostring

Voter ID EPIC number.

consent?string

Consent flag. Defaults to 'Y'.

clientData?object

Custom metadata to associate with the request.

Empty Object

Response Body

curl -X POST "https://__playground__/verification/v3/voter_id_verification/verify" \  -H "Content-Type: application/json" \  -d '{    "epicNo": "ABC1234567"  }'

{
  "success": true,
  "status_code": 200,
  "provider": "KwikID",
  "api_name": "Voter ID Verification",
  "data": {
    "requestId": "ef2358fa-b687-4a71-8c46-f5ac45f365e2",
    "result": {
      "acNo": "2",
      "rlnName": "XXX XXX yadav",
      "partNo": "93",
      "stCode": "S20",
      "district": "Ganganagar",
      "epicNo": "ABC1234567",
      "state": "Rajasthan",
      "slNoInPart": "XXX",
      "sectionNo": "1",
      "acName": "Ganganagar",
      "psName": "XX XX XX XXXX XXXX",
      "rlnType": "F",
      "pcName": "XX",
      "name": "XX XX",
      "gender": "M",
      "age": 27,
      "nameV1": "XX XX",
      "partName": "Ward No. XX"
    },
    "statusCode": 101
  }
}
{
  "detail": {},
  "message": "string"
}
{
  "error": "string"
}

Overview

Call POST /verification/v3/voter_id_verification/verify from your backend to verify Voter ID card details (EPIC number) using KwikID.

Key features

  • ECI details: Fetches name, age, gender, state, district, assembly, and parliamentary constituency.
  • Upstream provider: Connects directly to the national electoral registry via KwikID.

Implementation

Step 1: Call from your backend

POST /verification/v3/voter_id_verification/verify HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json

{
  "epicNo": "ABC1234567"
}

Step 2: Use the response

On success (200 OK), the response returns elector profile and constituency metadata:

{
  "success": true,
  "status_code": 200,
  "provider": "KwikID",
  "api_name": "Voter ID Verification",
  "data": {
    "requestId": "ef2358fa-b687-4a71-8c46-f5ac45f365e2",
    "result": {
      "acNo": "2",
      "rlnName": "XXX XXX yadav",
      "partNo": "93",
      "stCode": "S20",
      "district": "Ganganagar",
      "epicNo": "ABC1234567",
      "state": "Rajasthan",
      "slNoInPart": "XXX",
      "sectionNo": "1",
      "acName": "Ganganagar",
      "psName": "XX XX XX XXXX XXXX",
      "rlnType": "F",
      "pcName": "XX",
      "name": "XX XX",
      "gender": "M",
      "age": 27,
      "nameV1": "XX XX",
      "partName": "Ward No. XX"
    },
    "statusCode": 101
  }
}