Search Overlay

Rerun a Customer Identity Check

POST /customeridentification/v1/identityprofiles/customer_identity_check_id/rerunfailedchecks

If you have run a Customer Identity Check request and received ERROR as a decision response, this could indicate that the request could not be completed for some reason. In this case, you can rerun the request using only the id returned to the response.

Do not rerun a Customer Identity Check request if the decision in the response to the initial request is FAIL. You will get the same FAIL decision if you resubmit it.

To rerun a Customer Identity Check, you must initiate a POST request to the rerunfailedchecks endpoint.

See our full API documentation for a complete description of the parameters required to rerun a Customer Identity Check request.

curl -X POST \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
-d ' '

Prior to trying the example, you should:

  • Replace the ID of the Customer Identity Check (86dcb68d-cbd0-4878-8da7-ffc0e6554513) in the URL with the ID you received in the response you received to your original Customer Identity Check.
  • Replace the API key (after the -u) with the API key you have received.

"id": "86dcb68d-cbd0-4878-8da7-ffc0e6554513",
"decision": "SUCCESS",
"merchantRefNum": "KYC_1520461749",
"card": {
"lastDigits": "1111",
"cardExpiry": {
"month": 2,
"year": 2019
"profile": {
"firstName": "John",
"lastName": "Smith",
"email": "",
"currentAddress": {
"street": "100 Queen Street West",
"street2": "Unit 201",
"city": "Toronto",
"state": "ON",
"country": "CA",
"zip": "M5H 2N2",
"monthsAtAddress": "20",
"phone": "647-788-3901"
"previousAddresses": [{
"city": "Calgary",
"state": "AB",
"street": "2124 Westchester street",
"street2": "string",
"zip": "M2H 2G6",
"country": "CA",
"monthsAtAddress": "30"
"dateOfBirth": {
"day": "25",
"month": "12",
"year": "1980"
"sinLastFour": "6789"
"customerIp": "",
"vendorCheck": "EID_COMPARE",
"providerResponses": {
"eidCompare": {
"id": "0f1266b9-ce28-4df2-bc3f-d4b746cc1ced",
"status": "SUCCESS",
"response": {
"assessmentComplete": {
"reasonCodes": [{
"description": "Telephone exchange does not match the FSA (first three characters) of the postal code for Current Address",
"code": "08"
"decision": "Y",
"score": 25

For details about the parameters returned in the response, see Run a Customer Identity Check.

On this Page