v1

latestOpenAPI 3.1.02026-07-2656114159.7 KB

Identity Verification

Verify Voter's Card

Verify a voter's card and retrieve the identity details attached to the voter ID.

post/api/v1/merchant/documents/voters-card

Headers

api-keystring required

Your Payvessel public API key

api-secretstring required

Your Payvessel secret

Content-Type'application/json' required

Request content type

Request body

voters_idstring required

Voter's identification number

Example request

{
  "voters_id": "AKD12345678901"
}

Response

Voter's card verification response

successboolean required

messagestring required

Example response

{
  "success": true,
  "message": "Voter's card verification completed successfully",
  "data": {
    "first_name": "John",
    "middle_name": "Adebayo",
    "last_name": "Doe",
    "gender": "MALE",
    "birth_date": "1992-08-14",
    "photo": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "voters_id": "AKD12345678901",
    "polling_unit": "Ward 4 Unit 12",
    "state": "Lagos",
    "lga": "Ikeja"
  },
  "charges": {
    "charged_amount": "0.00"
  }
}