Request a fraud evaluation
200 400: Bad Request Missing customer data 401: Unauthorized Invalid token 403: Forbidden Service or user not authorized
Copy {
"requestId" : "ayclpQyi6p" ,
"event" : "evaluation" ,
"evaluation" : {
"type" : "fraud" ,
"status" : "initiated"
} ,
"validation" : {
"status" : "APPROVED" ,
"kyc" : "PASSED" ,
"fraudScore" : 0.82
} ,
"externalId" : "abcd-123-456-efgh" ,
"customerId" : "<customer-id>" ,
"uri" : "https://app.waldo.ai/customers/<customer-id>" ,
"errors" : []
}
Copy {
"code" : "INVALID_DATA" ,
"message" : "Invalid <field name>"
}
Copy {
"code": "INVALID_TOKEN",
"message": "Invalid token."
}
Copy {
"code": "NOT_AUTHORIZED",
"message": "You are not authorized to perform this action. Please contact support for assistance."
}
Webhooks complete event notification
Copy {
"event" : "evaluation" ,
"evaluation" : {
"type" : "fraud" ,
"status" : "completed"
} ,
"customerId" : "<customer-id>" ,
"uri" : "https://app.waldo.ai/customers//<customer-id>" ,
"validation" : {
"status" : "APPROVED" ,
"kyc" : "PASSED" ,
"fraudScore" : 0.89 ,
"fraudFlag" : false ,
"warnings" : 3 ,
"warningTags" : {
"ssn" : {
"tag" : "ssn" ,
"label" : "SSN Integrity" ,
"passed" : true
} ,
"date_of_birth" : {
"tag" : "date_of_birth" ,
"label" : "Date of Birth Integrity" ,
"passed" : true
} ,
"address" : {
"tag" : "address" ,
"label" : "Address Integrity" ,
"passed" : true
} ,
"legal_and_regulatory_warnings" : {
"tag" : "legal_and_regulatory_warnings" ,
"label" : "Legal and Regulatory Warnings" ,
"passed" : true
} ,
"politically_exposed_person" : {
"tag" : "politically_exposed_person" ,
"label" : "Politically Exposed Person" ,
"passed" : true
} ,
"sanction" : {
"tag" : "sanction" ,
"label" : "Sanctions List" ,
"passed" : true
} ,
"fraud_reports" : {
"tag" : "fraud_reports" ,
"label" : "Network Fraud Detection" ,
"passed" : false
} ,
"watchlists_validation" : {
"tag" : "watchlists_validation" ,
"label" : "Watchlists Validation" ,
"passed" : true
} ,
"phone_number_validation" : {
"tag" : "phone_number_validation" ,
"label" : "Phone Number Validation" ,
"passed" : false
} ,
"email_address_validation" : {
"tag" : "email_address_validation" ,
"label" : "Email Address Validation" ,
"passed" : false
}
} ,
"kycBreakdown" : {
"identityBreakdown" : {} ,
"watchlistBreakdown" : {} ,
"documentBreakdown" : {}
}
}
}