ID Verification

ECOWAS (Ghana Card)

Instant verification

/verification/ecowas

Verify ECOWAS (Ghana card) ID card for Affinity partners

Request parameters

Responses

            {
                "message": "Verification passed",
                "success": true,
                "requestId": "AFVER_EC_01J3FYXHWXBJA09E1N6MPJH7Z1",
                "data": {
                "nationalId": "GHA-000000000-0",
                "cardId": "AFF0000000000",
                "cardValidFrom": "2021-03-18",
                "cardValidTo": "2031-03-17",
                "surname": "Afi",
                "forenames": "Nti",
                "nationality": "Ghana",
                "birthDate": "1990-04-13",
                "gender": "MALE",
                "selfie": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAQDAwQDAwQEAwQ..."
                }
            }
        

            {
                "message": "Verification failed",
                "success": false,
                "requestId": "AFVER_EC_01J3FYXHWXBJA09E1N6MPJH7Z1",
                "errorCode": "VERIFICATION_FAILED"
            }
        

            {
                "message": "The data provided is invalid",
                "errors": [
                    {
                        "field": "idNumber",
                        "message": "Incorrect format. Must match 'AAA-000000000-0'"
                    }
                ],
                "errorCode": "VALIDATION_ERROR",
                "errorId": "01J3FZG2959C0MC984M8QC1GXA"
            }
        

            {
                "message": "A problem occurred while processing your request",
                "errorId": "01J3FZG2959C0MC984M8QC1GXA"
            }
        

Yes/No verification

/verification/ecowas/yes-no

Verify ECOWAS (Ghana card) ID card for Affinity partners with no biodata

Request parameters

Responses

            {
                "message": "Verification passed",
                "success": true,
                "requestId": "AFVER_EC_01J3FYXHWXBJA09E1N6MPJH7Z1"
            }
        

{
  "message": "example",
  "success": false,
  "requestId": "example",
  "errorCode": "example"
}

{
  "message": "example",
  "errors": [
    {
      "field": "example",
      "message": "example"
    }
  ],
  "errorCode": "example",
  "errorId": "example"
}

{
  "message": "example",
  "errorId": "example"
}

Last modified: 27 August 2025