Truth Data API

The Arkose Labs Fraud and Abuse Prevention Platform (Arkose Labs Platform) relies on data to improve its fraud detection process. The data is used to evaluate whether or not a given user is engaged in suspicious behavior. The more data we have, the more accurate we can be.

Arkose Labs has provided two APIs for customers to use to notify us of particular instances of fraudulent activity, or of non-suspicious users that had pressure applied to them.

The APIs are:

  • https://customer-sessions.arkoselabs.com/nonlegit - For any session that was successfully completed by a fraudster.  For example, if abusive behavior was found for a given user, and it was traced back to a session, then send that session to this api.  
  • https://customer-sessions.arkoselabs.com/legit -  For any session that was identified as fraudulent but was actually non-suspicious. Great care is taken to ensure that non-suspicious users receive as little friction as possible however,  some may be hit with additional pressure from the Arkose Labs Platform.  

To use either API, send through a POST request with the following JSON body:

{
    "publicKey": "<your public key>",
    "privateKey": "<your private key>",
    "sessions": ["<session1>",
                 "<session2>",
                 ...
				]
}

Additionally, you can provide extra context around each session.  For example, if you wish to provide some information around usernames for each session, you can use the format below:

{
    "publicKey": "<your public key>",
    "privateKey": "<your private key>",
    "sessions": [
	{
		"session:"<session>",
		"customValue1": "<value1>",
		"customValue2": "<value2>",
		"customValue3": "<value3>",
		"customValue4": "<value4>"
	}
    ...
	]
}

Currently, we only accept "customValue1", "customValue2", "customValue3", "customValue4" as valid additional context

Please send no more than 5,000 sessions per request.

Was this article helpful?
0 out of 0 found this helpful