Verify transactions, including logins and payments, by analyzing the behavioral pattern of each user and matching it to in-app transaction history. Transactions initiated at unfamiliar locations will increase the Incognia risk score and can be used to trigger step-up authentication.
We secure digital transactions by matching the historical location fingerprint and the transaction history of the initiating user, to their real-time location. Transactions initiated at unfamiliar locations will result in a higher risk score. In-store transactions are secured when we match the user's real-time location with the indicated store.
Prevent fraudsters from taking over user accounts by continually analyzing user location behavior. If Incognia detects suspicious location activity, you can trigger additional authentication to confirm the user is legitimate.
login
is supported. payment
coming soon.{"id": "dfe1f2ff-8f0d-4ce8-aed1-af8435143044","risk_assessment": "low_risk","evidence": {// For a complete explanation of this part of the response,// please refer to the evidence page in the docs."device_model": "Moto Z2 Play","known_account": true,"location_services": {"location_permission_enabled": true,"location_sensors_enabled": true},"device_integrity": {"probable_root": false,"emulator": false,"gps_spoofing": false,"from_official_store": true},"device_fraud_reputation": "unknown","distance_to_trusted_location": 21.06295635345013,"last_location_ts": "2022-11-01T22:45:53.299Z","sensor_match_type": "gps"}}
{"errors": ["missing installation_id"]}
Empty.
Unable to find user installation. Please try again later and check your SDK integration
Empty.
{"installation_id": "LX2K9uIfkPIL2UIXxQCqSXDTPKkG8gLG2heKnlMrwAaCLV2KHxuji1WLElDrFBlWYJLCwbkghZVmp5WVb6UAjfxlgcExS3W1fgQ4j0ikcp7Z8x9dGTaYcVFXVf0fupbcvhI8Nh0RO9oy+3NavbBX7Q","account_id": "c3ab8ff13720e8ad9047dd39466b3c8974e592c2fa383d4a3960714caef0c4f2","type": "login"}
Sample cURL:
curl -XPOST -H "Content-type: application/json" -H "Authorization: Bearer <token>" -d @body.json "https://api.us.incognia.com/api/v2/authentication/transactions"
Response body
For a 200-OK response, these are the fields you should expect as a result:
Response field | Type | Description |
id | string | Unique transaction identifier which can be used to verify if the assessment changed in later calls. |
request_id | string | Unique request identifier. Used for audit purposes. |
risk_assessment | string | Assessment result. It may be one of high_risk, low risk, unknown risk. For more information refer to Understanding risk assessments. |
evidence | object | An object with supporting evidence for the risk assessment. For more information refer to Understanding risk assessments. |
{"id": "5e76a7ca-577c-4f47-a752-9e1e0cee9e49","request_id": "8afc84a7-f1d4-488d-bd69-36d9a37168b7","risk_assessment": "low_risk","evidence": {// For a complete explanation of this part of the response,// please refer to the evidence page in the docs."device_model": "Moto Z2 Play","geocode_quality": "good","location_events_near_address": 38,"location_events_quantity": 288,"location_services": {"location_permission_enabled": true,"location_sensors_enabled": true},"device_integrity": {"probable_root": false,"emulator": false,"gps_spoofing": false,"from_official_store": true}}}
Empty.
Unable to find the given sign up id.
Empty.
Sample cURL:
curl -H "Authorization: Bearer <token>" "https://api.us.incognia.com/api/v2/authentication/transactions/<id>"
Response body
For a 200-OK response, these are the fields you should expect as a result:
Response field | Type | Description |
id | string | Unique transaction identifier which can be used to verify if the assessment changed in later calls. |
request_id | string | Unique request identifier. Used for audit purposes. |
risk_assessment | string | Assessment result. It may be one of high_risk, low risk, unknown risk. For more information refer to Understanding risk assessments. |
evidence | object | An object with supporting evidence for the risk assessment. For more information refer to Understanding risk assessments. |
​