Verify API v4 Response Fields and Examples

Session Characteristics

These fields contain information about the session itself.

Field NameDescriptionExample ValuesApplicable Product
solvedWhen a session's risk level does not qualify it for transparent mode (no challenge) it is shown an interactive challenge. In that case, this field's value indicates if the challenge was successfully solved or not.

If it was in transparent mode, the field value for a valid session is true.
true, falseArkose Protect
sessionA unique token for the Arkose Labs session. A session is the whole experience from solution load to verification.A unique token, e.g.
3595d2c014d3c5f01.1116018803,
or null
Arkose Detect
Arkose Protect
session_createdAn ISO 8601 UTC timestamp signifying the time the session was createde.g.
2019-07-15T02:45:13+00:00,
or null
Arkose Detect
Arkose Protect
check_answerAn ISO 8601 UTC timestamp signifying the time that the Enforcement Challenge user supplied answered were evaluatede.g.
2019-07-15T02:45:13+00:00,
or null
Arkose Protect
verifiedAn ISO 8601 UTC timestamp signifying the time that the request to the verify endpoint was made.e.g.
``2019-07-15T02:45:13+00:00
Arkose Detect
Arkose Protect
attemptedWhether the user attempted to solve the Enforcement Challenge, or not.true, falseArkose Protect
security_levelA number that indicates the security level used for this session.

Be aware that security_level can have a null value - usually because the session was an audio mode session. Audio mode does not use security_level.
A security level, e.g. 20Arkose Protect
session_is_legitIndicates if Arkose Labs certifies there are no telltales of non-legitimate activity in the session.true, falseArkose Detect
Arkose Protect
previously_verifiedIndicates if a session has already been verifiedtrue, falseArkose Detect
Arkose Protect
session_timed_outIndicates if a session timed out before it was solvedtrue, falseArkose Detect
Arkose Protect
suppress_limitedIndicates if the session qualified for low security, but failed verification. Low security is when a session has qualified to run in transparent mode, or use a no wrong answer enforcement challenge, such as the pick your favorite color challenge.true, falseArkose Protect
theme_arg_invalidWhether the theme arg setting at verification matched the original theme arg passed in at session setup.

A theme arg is a parameter passed by a customer to Arkose Labs. It requests a security tier or UX test mode.
true, falseArkose Protect
suppressedSuppressed is the old name for transparent mode. This field shows if the the user was offered transparent mode.true, falseArkose Protect
punishable_actionedPunishable is an attack mitigation tactic, which randomly fails verification attempts, even if the response was correct. This field indicates if punishable was activated.true, falseArkose Protect
telltale_userUID for a combination of telltales that identify a particular bad user or organization.A string such as 999b-fwh,
or null
Arkose Detect
Arkose Protect
failed_low_sec_validationIndicates that the intention was to offer the user a low security session, but they failed to qualify for it when the verification was attempted.true, falseArkose Protect
lowsec_errorAn identifier showing why a user was denied a low security session."user_credits", "rate_limit_local", "validation_checks", "rate_limit_global", or nullArkose Detect
Arkose Protect
lowsec_level_deniedThe low security level that was denied to the user.A security level, e.g. 5Arkose Detect
Arkose Protect
uaThe User Agent string for the user that interacted with the EC."Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36“Arkose Detect
Arkose Protect
ip_rep_listAn identifier which specifies which IP reputation database this IP address has been seen at."tor", "sfs_tor", "sfs", or nullArkose Detect
Arkose Protect
optionalAn object containing optional return values such as client_encrypted_mode_key or get_pass values.

Also, relevant data being sent to Arkose Labs via our accepted methods (see: Data Exchange (Requires Support login)) appears in this object.

The specific keys and values inside this object vary based on implementation
{"blob": "lHpwagBqx3JOI7t9Ka0KUdIeHZbIjAYPPB72k Du2Zb5BwNiC6qJx5gS0f5c3EzcZ9d"}, or nullArkose Detect
Arkose Protect
game_number_limit_reachedGame number limit is an optional setting that restricts the number of attempts a user can have at solving the EC. This field can show if the user reached the number of attempts allowed.true, falseArkose Protect
user_language_shownShows the language code of the language in which the challenge was presented to the user.A string such as “en“ or nullArkose Protect
telltale_listThe list of telltales that were identified as possible candidates during a session.A string e.g. "999b-fwh", or nullArkose Detect
Arkose Protect
device_id
[Early Access]
Note: You must request that Arkose turn on device_id for your account. Otherwise, its value will always be null
device_id can identify changes a user's device if those two devices are distinguishable based on collected fingerprints.
device_id isn't comprised of uniquely identifiable attributes and so can't be used for situations when, for example, a user switched from one iPhone 14 to another while keeping all the settings the same.
A string containing a hash value or null
challenge_typeThe type of challenge that the end-user solved.A string e.g. "audio", "transparent", "visual" or nullArkose Detect
Arkose Protect

Fingerprint

The following sections (Browser Characteristics, Device Characteristics, User Preference, IP Intelligence) are fields containing information that identify the browser, device, etc. the session ran on.

Browser Characteristics

These fields contain information about the device the session ran on.

Field NameDescriptionExample ValuesApplicable Product
browser_nameThe name of the browser the user was using.A string, e.g. Chrome or nullArkose Detect
Arkose Protect
browser_versionThe version of the browser the user was using.A version number, e.g. 92.0.4515.159 or nullArkose Detect
Arkose Protect
color_depthThe color depth of the device used for the session.A number, e.g. 24 or nullArkose Detect
Arkose Protect
session_storageWhether session storage was available or not.true, falseArkose Detect
Arkose Protect
indexed_databaseWhether the browser uses any indexed database API.true, falseArkose Detect
Arkose Protect
canvas_fingerprintThe canvas fingerprint value of the browser.e.g. 1652956012 or nullArkose Detect
Arkose Protect

Device Characteristics

These fields contain information about the device the session ran on.

Field NameDescriptionExample ValuesApplicable Product
operating_systemThe operating system used on the device.e.g. Windows or nullArkose Detect
Arkose Protect
operating_system_versionThe version of the operating system used on the device.e.g. XP or nullArkose Detect
Arkose Protect
screen_resolutionThe current screen resolution of the device.e.g. [1920,1080] or nullArkose Detect
Arkose Protect
max_resolution_supportedThe maximum supported screen resolution of the device.e.g. [1920,1080] or nullArkose Detect
Arkose Protect
behaviorWhether the device / browser supports the addBehavior method. Note that addBehavior is considered obsolete with Windows 10.true, falseArkose Detect
Arkose Protect
cpu_classThe CPU class identifier of the device.e.g. X86 or nullArkose Detect
Arkose Protect
platformThe platform the device belongs to.e.g. MacIntel or nullArkose Detect
Arkose Protect
touch_supportWhether the device has touch support or not.true, falseArkose Detect
Arkose Protect
hardware_concurrencyThe hardware concurrency support of the device.e.g. 8 or nullArkose Detect
Arkose Protect

User Preference Field

This field contains information about the session set by its user.

Field NameDescriptionExample ValuesApplicable Product
timezone_offsetThe timezone offset from UTC.e.g. 1000 or nullArkose Detect
Arkose Protect

IP Intelligence Fields

These fields contain information related to and derived from the IP address associated with the session.

Field NameDescriptionExample ValuesApplicable Product
timezoneThe timezone the session was originated from.A string, e.g.
America/Los_Angeles or null
Arkose Detect
Arkose Protect
user_ipThe IP address of the device used for the session.An IP address, e.g.
199.220.42.206, or null
Arkose Detect
Arkose Protect
is_torIndicates if the IP is suspected of being a TOR connection (either active or previously hosted TOR nodes and exist).true, falseArkose Detect
Arkose Protect
is_vpnIndicates if the IP is suspected of being a VPN connection. For example, it has been on a VPN and can include data center ranges.true, falseArkose Detect
Arkose Protect
is_proxyIndicates if this IP address suspected to be a proxy.true, falseArkose Detect
Arkose Protect
is_botWhether the session is bot-originated or not.true, falseArkose Detect
Arkose Protect
countryCountry the User IP belongs to.A string, e.g. US or null.Arkose Detect
Arkose Protect
regionState/Region that the IP belongs to.A string, e.g. California or null.Arkose Detect
Arkose Protect
cityThe city the IP belongs to.A string, e.g. Fremont or nullArkose Detect
Arkose Protect
ispThe Internet Service Provider name.A string, e.g. AT&T U-verse or nullArkose Detect
Arkose Protect
public_access_pointWhether the IP address belongs to education and research institutions, corporates, or public WiFi such as hotel lobby, coffee shop, etc.true, falseArkose Detect
Arkose Protect
connection_typeWhether the connection type belongs to one of the following categories: Residential, Corporate, Education, Mobile, Data CenterA string, e.g. Residential or nullArkose Detect
Arkose Protect
latitudeThe latitude coordinates of the device used for the session.e.g. 37.52809906 or nullArkose Detect
Arkose Protect
longitudeThe longitude coordinates of the device used for the session.e.g. -121.97319794 or nullArkose Detect
Arkose Protect

Sample Verify API Responses

The following examples show different Verify API responses. They show the typical values in each field for each type of response.

{
    "session_details": {
        "solved": true,
        "session": "22612c147bb418c8.2570749403",
        "session_created": "2021-08-29T23:13:03+00:00",
        "check_answer": "2021-08-29T23:13:16+00:00",
        "verified": "2021-08-30T00:19:32+00:00",
        "attempted": true,
        "security_level": 30,
        "session_is_legit": false,
        "previously_verified": true,
        "session_timed_out": true,
        "suppress_limited": false,
        "theme_arg_invalid": false,
        "suppressed": false,
        "punishable_actioned": false,
        "telltale_user": "eng-1362-game3-py-0.",
        "failed_low_sec_validation": false,
        "lowsec_error": null,
        "lowsec_level_denied": null,
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36",
        "ip_rep_list": null,
        "game_number_limit_reached": false,
        "user_language_shown": "en",
        "device_id": null,
        "telltale_list": [
            "eng-1362",
            "eng-1362-game3-py-0."
        ],
        "optional": null
    },
    "fingerprint": {
        "browser_characteristics": {
            "browser_name": "Chrome",
            "browser_version": "92.0.4515.159",
            "color_depth": 24,
            "session_storage": false,
            "indexed_database": false,
            "canvas_fingerprint": 1652956012
        },
        "device_characteristics": {
            "operating_system": null,
            "operating_system_version": null,
            "screen_resolution": [
                1920,
                1080
            ],
            "max_resolution_supported": [
                1920,
                1057
            ],
            "behavior": false,
            "cpu_class": "unknown",
            "platform": "MacIntel",
            "touch_support": false,
            "hardware_concurrency": 8
        },
        "user_preferences": {
            "timezone_offset": -600
        }
    },
    "ip_intelligence": {
        "user_ip": "10.211.121.196",
        "is_tor": false,
        "is_vpn": true,
        "is_proxy": true,
        "is_bot": true,
        "country": "AU",
        "region": "New South Wales",
        "city": "Sydney",
        "isp": "Amazon.com",
        "public_access_point": false,
        "connection_type": "Data Center",
        "latitude": "-38.85120035",
        "longitude": "106.21220398",
        "timezone": "Australia/Sydney"
    }
}
{
    "session_details": {
        "solved": false,
        "session": "22612c147bb418c8.2570749403",
        "session_created": "2021-08-29T23:13:03+00:00",
        "check_answer": "2021-08-29T23:13:16+00:00",
        "verified": "2021-08-30T00:19:32+00:00",
        "attempted": true,
        "security_level": 30,
        "session_is_legit": false,
        "previously_verified": true,
        "session_timed_out": true,
        "suppress_limited": false,
        "theme_arg_invalid": false,
        "suppressed": false,
        "punishable_actioned": false,
        "telltale_user": "eng-1362-game3-py-0.",
        "failed_low_sec_validation": false,
        "lowsec_error": null,
        "lowsec_level_denied": null,
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36",
        "ip_rep_list": null,
        "game_number_limit_reached": false,
        "user_language_shown": "en",
        "telltale_list": [
            "eng-1362",
            "eng-1362-game3-py-0."
        ],
        "optional": null
    },
    "fingerprint": {
        "browser_characteristics": {
            "browser_name": "Chrome",
            "browser_version": "92.0.4515.159",
            "color_depth": 24,
            "session_storage": false,
            "indexed_database": false,
            "canvas_fingerprint": 1652956012
        },
        "device_characteristics": {
            "operating_system": null,
            "operating_system_version": null,
            "screen_resolution": [
                1920,
                1080
            ],
            "max_resolution_supported": [
                1920,
                1057
            ],
            "behavior": false,
            "cpu_class": "unknown",
            "platform": "MacIntel",
            "touch_support": false,
            "hardware_concurrency": 8
        },
        "user_preferences": {
            "timezone_offset": -600
        }
    },
    "ip_intelligence": {
        "user_ip": "10.211.121.196",
        "is_tor": false,
        "is_vpn": true,
        "is_proxy": true,
        "is_bot": true,
        "country": "AU",
        "region": "New South Wales",
        "city": "Sydney",
        "isp": "Amazon.com",
        "public_access_point": false,
        "connection_type": "Data Center",
        "latitude": "-38.85120035",
        "longitude": "106.21220398",
        "timezone": "Australia/Sydney"
    }
}
{
    "error": "DENIED ACCESS",
    "verified": "2021-08-30T22:15:00+00:00"
}
{
    "session_details": {
        "solved": true,
        "session": "22612c147bb418c8.2570749403",
        "session_created": "2021-08-29T23:13:03+00:00",
        "check_answer": "2021-08-29T23:13:16+00:00",
        "verified": "2021-08-30T00:19:32+00:00",
        "attempted": true,
        "security_level": 30,
        "session_is_legit": false,
        "previously_verified": true,
        "session_timed_out": true,
        "suppress_limited": false,
        "theme_arg_invalid": false,
        "suppressed": false,
        "punishable_actioned": false,
        "telltale_user": "eng-1362-game3-py-0.",
        "failed_low_sec_validation": false,
        "lowsec_error": "user_credits",
        "lowsec_level_denied": null,
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36",
        "ip_rep_list": null,
        "game_number_limit_reached": false,
        "user_language_shown": "en",
        "telltale_list": [
            "eng-1362",
            "eng-1362-game3-py-0."
        ],
        "optional": null
    },
    "fingerprint": {
        "browser_characteristics": {
            "browser_name": "Chrome",
            "browser_version": "92.0.4515.159",
            "color_depth": 24,
            "session_storage": false,
            "indexed_database": false,
            "canvas_fingerprint": 1652956012
        },
        "device_characteristics": {
            "operating_system": null,
            "operating_system_version": null,
            "screen_resolution": [
                1920,
                1080
            ],
            "max_resolution_supported": [
                1920,
                1057
            ],
            "behavior": false,
            "cpu_class": "unknown",
            "platform": "MacIntel",
            "touch_support": false,
            "hardware_concurrency": 8
        },
        "user_preferences": {
            "timezone_offset": -600
        }
    },
    "ip_intelligence": {
        "user_ip": "10.211.121.196",
        "is_tor": false,
        "is_vpn": true,
        "is_proxy": true,
        "is_bot": true,
        "country": "AU",
        "region": "New South Wales",
        "city": "Sydney",
        "isp": "Amazon.com",
        "public_access_point": false,
        "connection_type": "Data Center",
        "latitude": "-38.85120035",
        "longitude": "106.21220398",
        "timezone": "Australia/Sydney"
        }
}
{
    "session_details": {
        "solved": false,
        "session": "22612c147bb418c8.2570749403",
        "session_created": "2021-08-29T23:13:03+00:00",
        "check_answer": "2021-08-29T23:13:16+00:00",
        "verified": "2021-08-30T00:19:32+00:00",
        "attempted": true,
        "security_level": 30,
        "session_is_legit": false,
        "previously_verified": true,
        "session_timed_out": true,
        "suppress_limited": false,
        "theme_arg_invalid": false,
        "suppressed": false,
        "punishable_actioned": false,
        "telltale_user": "eng-1362-game3-py-0.",
        "failed_low_sec_validation": false,
        "lowsec_error": null,
        "lowsec_level_denied": null,
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36",
        "ip_rep_list": null,
        "game_number_limit_reached": false,
        "user_language_shown": "en",
        "telltale_list": [
            "eng-1362",
            "eng-1362-game3-py-0."
        ],
        "optional": {
            "blob": "BbfYFeKzwEwnGCAU.fCWy85IOHQ2j2SomSW6bf6Mibfgdlqn7MWyoY8JbYkVskPsLbqBqryeAR0EVC1pi5XosVJjPfvWZ4H6EBQgC5XYnHVeKwQ=="
        }
    },
    "fingerprint": {
        "browser_characteristics": {
            "browser_name": "Chrome",
            "browser_version": "92.0.4515.159",
            "color_depth": 24,
            "session_storage": false,
            "indexed_database": false,
            "canvas_fingerprint": 1652956012
        },
        "device_characteristics": {
            "operating_system": null,
            "operating_system_version": null,
            "screen_resolution": [
                1920,
                1080
            ],
            "max_resolution_supported": [
                1920,
                1057
            ],
            "behavior": false,
            "cpu_class": "unknown",
            "platform": "MacIntel",
            "touch_support": false,
            "hardware_concurrency": 8
        },
        "user_preferences": {
            "timezone_offset": -600
        }
    },
    "ip_intelligence": {
        "user_ip": "10.211.121.196",
        "is_tor": false,
        "is_vpn": true,
        "is_proxy": true,
        "is_bot": true,
        "country": "AU",
        "region": "New South Wales",
        "city": "Sydney",
        "isp": "Amazon.com",
        "public_access_point": false,
        "connection_type": "Data Center",
        "latitude": "-38.85120035",
        "longitude": "106.21220398",
        "timezone": "Australia/Sydney"
    }
}