Ghana Card Verification

Ghana Card Verification API

This endpoint is used to verify the details of a Ghana Card. It requires the Ghana Card number and other relevant details of the cardholder.

Endpoint: POST {baseurl}/v1/api/verification/ghana-card

Request Body

Field Name	Type	Required	Description
country	string	Yes	The country code for the Ghana Card. Example: GHA.
reference	string	Yes	A unique reference for the verification request. Example: 0122333444455555.
identity	string	Yes	A unique identifier for the user. Example: 6791457be570f7f292f1fe23.
verificationLevel	string	Yes	The level of verification to perform. Example: basic.
cardNumber	string	Yes	The Ghana Card number to verify. Example: GHA-123456789-0.
image	string	No	A base64-encoded image of the Ghana Card for additional verification.

Example Request Body

{
    "country": "GHA",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "cardNumber": "GHA-123456789-0",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}

Sample Request

curl

curl -X POST "{baseurl}/v1/api/verification/ghana-card" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
    "country": "GHA",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "cardNumber": "GHA-123456789-0",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}'

Sample Response

{
    "status": true,
    "responseCode": "00",
    "statusCode": "200",
    "message": "Ghana Card verification successful",
    "data": {
        "nationalId": "GHA12www34r6789",
        "expiryDate": "2030-01-01",
        "lastName": "Smith",
        "firstName": "John",
        "nationality": "Ghanaian",
        "dateOfBirth": "1990-01-01"
    },
    "meta": {
        "statusCode": "200",
        "isValid": true,
        "timeStamp": "Thu Apr 24 2025 12:27:28 GMT+0000 (Coordinated Universal Time)"
    }
}