Base URL: https://demo-api.incodesmile.com — Incode demo environment
Returns raw id-validation-service check results with original naming preserved (no mapping to user-service key constants, no threshold-binarization), plus the raw checkFraudRisk result.
Path & query parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
query | string | Id of interview for which raw IDV results are requested. If not present, it will be extracted from token. | |
api-version |
header | string | yes |
Responses
200
OK
Response body (application/json):
| Field | Type | Required | Description |
|---|---|---|---|
checkResults |
array[RawIdvCheckResultDto] | Raw id-validation-service check results. Empty when id-validation-service was not invoked for the interview. | |
checkResults.name |
string | Original id-validation-service check name, e.g. checkIdFaceTamper, checkIdScreenLiveness, deep_fraud. | |
checkResults.severity |
string | Check severity: low / medium / high. Enum: low, medium, high |
|
checkResults.version |
string | Model version that produced the result. | |
checkResults.result |
number (float) | Raw confidence/result value, Float in [0, 1]. Nullable when the check did not run. | |
fraudRisk |
FraudRiskDto | Raw checkFraudRisk result. Null when no FraudRisk was produced for the interview. | |
fraudRisk.name |
string | Check name, always checkFraudRisk. | |
fraudRisk.severity |
string | Check severity: low / medium / high. Enum: LOW, MEDIUM, HIGH |
|
fraudRisk.version |
string | Model version that produced the result. | |
fraudRisk.result |
number | Raw fraud-risk result value (full precision). | |
fraudRisk.responseText |
string | Free-text explanation returned by the fraud-risk model. | |
fraudRisk.responseCategory |
string | Response category returned by the fraud-risk model. | |
fraudRisk.topNFraudFeatures |
array[string] | Top N features that contributed towards a fraud classification. | |
fraudRisk.topNLegitFeatures |
array[string] | Top N features that contributed towards a legitimate classification. | |
fraudRisk.topNFraudCodes |
array[string] | Raw stable feature codes for topNFraudFeatures (same order), as sent by the model. | |
fraudRisk.topNLegitCodes |
array[string] | Raw stable feature codes for topNLegitFeatures (same order), as sent by the model. |
400
Bad Request
Response body (application/json):
| Field | Type | Required | Description |
|---|---|---|---|
timestamp |
integer (int64) | UTC timestamp in milliseconds | |
status |
integer (int32) | Custom error code or HTTP status code | |
error |
string | HTTP status error | |
message |
string | Custom error message | |
path |
string | Endpoint path | |
details |
object | Custom error details |