Rejection Reasons

Reject reason descriptions

Reject Reason	Description
idCardFail	The ID card contains an invalid CNP.
idCardRejected	The uploaded image is not an accepted document type.
idCardCnpMismatch	The CNP on the ID card does not match the expected CNP.
idCardExpired	The ID card has expired.
facematchStrongFail	Strong similarity check between Selfie and ID card photo.
facematchWeakFail	Moderate mode of checking the similarity between Selfie and the photo on the ID card. For cases when the ID card expiration date is approaching and the user’s face has undergone some changes.
selfieInBlocklist	The selfie matches with a face from the blocklist.
livenessFail	Liveness check failed due to one or more of the following reasons: smartphones detected in the frames, different people appearing in the frames, document appearing alongside selfies, static photos of people detected, multiple people looking at the camera.
genderFail	The estimated gender from liveness or selfie frames does not match the gender on the ID card.
ageEstimationWarning	The estimated age from liveness or selfie frames differs by more than 10 years compared to the ID card’s specified age.
idCardEdited	The ID card image appears to be edited, as indicated by metadata in the image header.
idCardTampered	The ID card image has a very high tampering score (4.5 or more) and signs of editing.
idCardTamperedSuspicion	The ID card image has a high tampering score (3.8 or more).

Rejection Reasons defaults and translations

Endpoint: GET https://api.x-faces.xyz/v1/project/<P_UUID>/rejection_reasons_defaults

where <P_UUID> is your project uuid (you can get it from url in board on project page).

Response:

The API returns a list of default rejection reasons configured for the specified project. Each reason includes metadata such as whether it should be verified (verify), whether it requires manual review (manual), and localization information.

{
  "default_rejection_reasons": {
    "reasonCode": {
      "localization": "{...}",
      "manual": true,
      "verify": true
    },
    "...": {}
  },
  "result": true
}

Default rejection reasons:

        {
  "default_rejection_reasons": {
    "ageEstimationWarning": {
      "localization": "{...}",
      "manual": true,
      "verify": true
    },
    "facematchStrongFail": {
      "localization": "{...}",
      "manual": false,
      "verify": false
    },
    "facematchWeakFail": {
      "localization": "{...}",
      "manual": true,
      "verify": true
    },
    "genderFail": {
      "localization": "{...}",
      "manual": false,
      "verify": false
    },
    "idCardCnpMismatch": {
      "localization": "{...}",
      "manual": false,
      "verify": false
    },
    "_more": "..."
  },
  "result": true
}