Face Match

Use this API to verify the facial features of your customer in one image with another. You can compare an image with another image or with an image in an ID. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.

Response Codes

Sub CodeStatusMessageNext Action
400ERRORFile size exceeded. Please check API DocumentationMaximum file size allowed for both the files is 10 MB.
400ERRORplease upload the file of valid format(jpeg/jpg/png)Allowed file type - JPEG/JPG/PNG.
400ERRORFirst image is missing in the requestUpload the scanned copy of the image 1.
400ERRORSecond image is missing in the requestUpload the scanned copy of the image 2.
400ERRORverification_id can include only alphanum, dot, hyphen and underscores.Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.
400ERRORx-client-id is missing in the request.Enter all the header information in the API request.
400ERRORClient secret belongs to test environmentEnter the correct environment credentials in the request.
401ERRORInvalid clientId and clientSecret combinationEnsure you enter valid x-client-id and x-client-secret information in the API request.
403ERRORIP not whitelisted your current ip is IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verificationWhitelist the IP address.
409ERRORverification id already existsEnter a unique verification ID to identify the request.
422ERRORInsufficient balance to process this requestTry again with sufficient balance.
500ERRORsomething went wrongTry again after some time.
502ERRORverification attempt failedTry again after some time.
Click Try It! to start a request and see the response here!