ID with Face Verification

This endpoint provides a powerful feature that enables users to verify the authenticity of an ID by comparing it with a face image. This process helps ensure that the document matches the person claiming ownership or authorization, adding an extra layer of security and trustworthiness. Whether it's validating identity documents such as passports, driver's licenses, or identification cards, this endpoint streamlines the verification process and reduces the risk of fraudulent activities.

👍
TEST DATA

id_number: RC6994032

selfie_image:

/9j/4AAQSkZJRgABAQAAAQABAAD/4gxYSUNDX1BST0ZJTEUAAQEAAAxITGlubwIQAABtbnRyUkdCIFhZWiAHzgACAAkABgAxAABhY3NwTVNGVAAAAABJRUMgc1JHQgAAAAAAAAAAAAAAAAAA9tYAAQAAAADTLUhQICAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABFjcHJ0AAABUAAAADNkZXNjAAABhAAAAGx3dHB0

📘
POST: https://api.prembly.com/verification/gh/id-card-with-face

Request Header

Key	Description
x-api-key	Your Secret Key

Request Body

Key	Description
id_number	Government issued Identity Card number
selfie_image	Base 64 encoding of face image

Sample Response

{
  "status": true,
  "response_code": "00",
  "message": "Ghana National ID with Image verification successful",
  "detail": "Ghana National ID with Image verification successful",
  "data": {
    "country": "GH",
    "identifier": "GHA-xxxxxxxxx-x",
    "complimentary": false,
    "verifiedAt": "2026-10-15T14:18:00.000Z",
    "firstName": "SOLOMON",
    "lastName": "OKAI",
    "middleName": "ARMAH",
    "dateOfBirth": "",
    "gender": ""
  },
  "face_data": {
    "status": false,
    "message": "No reference image available in verification data",
    "confidence": 0,
    "response_code": "01",
    "face_image_provided": "<base64 of the selfie sent>"
  },
  "meta": {},
  "billing_info": { "was_charged": true, "amount": "1530.00", "currency": "NGN" },
  "verification": { "status": "VERIFIED", "reference": "<uuid>", "verification_id": "<uuid>" },
  "reference_id": "VER-GHANA_ID_CARD_WITH_FACE-XXXXXXXXXX",
  "transaction_id": "<uuid>",
  "verification_status": "verified",
  "metadata": {}
}

Response Description

Response	Description
status	Indicates that the request was successful.
response_code	Represents the response code.
message	Provides additional information or a descriptive message related to the response.
data	An array containing the information received.
fullName	The full name of the individual.
first_name	The first name of the individual.
last_name	The last name of the individual.
gender	The gender of the individual.
dob	The date of birth of the individual.
address	The address of the individual.
document_name	The name of the document associated with the individual.
documentNumber	The number of the document associated with the individual.
documentType	The type of document associated with the individual.
documentCountry	The country code of the document issuer.
nationality	The nationality of the individual.
issuer	The name of the country that issued the document.
place_of_issue	The place where the document was issued.
date_of_issue	The date when the document was issued.
age	The age of the individual, calculated based on the date of birth.
expirationDate	The expiration date of the document associated with the individual.
device	Additional information about the device used for capturing the data.
image	A base64-encoded image of the individual's face.
Face_data	Information related to the face matching process.
status	The overall status of the face matching process.
response_code	A code representing the outcome of the face matching process.
message	A human-readable message describing the result of the face matching process.
confidence	The level of confidence or certainty associated with the face matching result.

👍TEST DATA

📘POST: https://api.prembly.com/verification/gh/id-card-with-face

Sample Response

Response Description

👍
TEST DATA

📘
POST: https://api.prembly.com/verification/gh/id-card-with-face