User Guides
Home
Start typing to search…

Integration Guide

Learn how to call the RiskOS™ Evaluation API for consumer identity verification with Socure Consumer Onboarding.

Consumer Onboarding API integration guide

This guide walks you through integrating with Socure’s /api/evaluation endpoint using the Consumer Onboarding workflow. You’ll learn how to send applicant identity + device data, parse results, and apply decision logic across identity verification, fraud detection, and compliance screening.


Before you start

Make sure your RiskOS™ environment is provisioned with:

A workflow configured for the Consumer Onboarding solution.

Postman Collection

The following Postman collection can be used to test the Consumer Onboarding solution with the Evaluation endpoint.



Choose your environment

Start with Sandbox for development and testing, then move to Production for live applications.

https://riskos.sandbox.socure.com/api/evaluation
  • No real customer data
  • Free testing environment
  • Unlimited API calls

Get an API key

  1. In the Sandbox RiskOS™ Dashboard, go to Developer Workbench > API Keys.
  2. Copy your API key securely.

How it works

  1. Send a POST /api/evaluation request with consumer identity and device data.
  2. RiskOS™ evaluates the request using your Consumer Onboarding workflow.
  3. You receive a decision (ACCEPT, REVIEW, REJECT, or RESUBMIT).
  4. If required, complete Document Verification asynchronously.
📘

Note: The decision values shown in this guide (ACCEPT, REVIEW, REJECT, RESUBMIT) reflect a customized Consumer Onboarding workflow.

Your environment may use different default decision values depending on how your workflow is configured.


Common integration inputs

The table below lists the typical set of PII inputs collected for the Consumer Onboarding solution.

These fields are not all required—different elements can be selectively included depending on the product modules used within your workflow.

You’ll find additional details below on input field formatting and structure within the API request.

FieldTypeDescriptionExample
given_nameStringFirst name of the consumer."Franky"
family_nameStringLast name of the consumer."Valley"
phone_numberStringConsumer's phone number in E.164 format."+1-667-368-1976"
date_of_birthStringConsumer's date of birth in ISO 8601 format (YYYY-MM-DD)."1992-03-11"
national_idStringNational identifier such as SSN, SIN, or equivalent, depending on geography."555667772"
emailStringConsumer's email address."[email protected]"
addressObjectConsumer's residential or mailing address, typically including street, city, region, postal code, and country."742 Evergreen Terrace, Apt 2B, Springfield, IL 62704, US"
di_session_tokenStringToken from the Digital Intelligence SDK that links the device session."eyJraWQiOi_di_token"

Start a new evaluation

Endpoint

POST https://riskos.sandbox.socure.com/api/evaluation
POST https://riskos.socure.com/api/evaluation

Authentication and headers

Include your API key in the Authorization header as a Bearer token, along with standard JSON headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json
X-API-Version: 2025-01-01.orion   # optional — pins a specific API version

Example request

{
  "id": "a86580cc-1733-4188-86b5-717166e1db8c",
  "timestamp": "2025-05-02T12:44:22.059Z",
  "workflow": "consumer_onboarding",
  "data": {
    "individual": {
      "id": "username",
      "given_name": "Franky",
      "middle_name": "",
      "family_name": "Valley",
      "national_id": "555667772",
      "date_of_birth": "1992-03-11",
      "email": "[email protected]",
      "phone_number": "16673681976",
      "address": {
        "line_1": "742 Evergreen Terrace",
        "line_2": "Apt 2B",
        "locality": "Springfield",
        "major_admin_division": "IL",
        "country": "US",
        "postal_code": "62704"
      },
      "additional_context": {
        "disclosure_purpose": "GLBA_502(e)"
      },
      "di_session_token": "eyJraWQiOi_di_token",
      "docv": {
        "config": {
          "send_message": true,
          "use_case_key": "",
          "language": ""
        }
      }
    }
  }
}
curl --location --request POST 'https://riskos.sandbox.socure.com/api/evaluation' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-raw '{
    "id": "a86580cc-1733-4188-86b5-717166e1db8c",
    "timestamp": "2025-05-02T12:44:22.059Z",
    "workflow": "consumer_onboarding",
    "data": {
      "individual": {
        "id": "username",
        "given_name": "Franky",
        "middle_name": "",
        "family_name": "Valley",
        "national_id": "555667772",
        "date_of_birth": "1992-03-11",
        "email": "[email protected]",
        "phone_number": "16673681976",
        "address": {
          "line_1": "742 Evergreen Terrace",
          "line_2": "Apt 2B",
          "locality": "Springfield",
          "major_admin_division": "IL",
          "country": "US",
          "postal_code": "62704"
        },
        "additional_context": {
          "disclosure_purpose": "GLBA_502(e)"
        },
        "di_session_token": "eyJraWQiOi_di_token",
        "docv": {
          "config": {
            "send_message": true,
            "use_case_key": "",
            "language": ""
          }
        }
      }
    }
  }'

Request schema

Top-level fields

Field

Type

Required

Description

Example

id

String

Required

Required, customer-defined unique identifier for the request.

This value must be unique for each evaluation. Reusing an ID causes RiskOS™ to treat the request as a re-run and can impact processing behavior, results, and downstream workflows.

"a86580cc-1733-4188-86b5-717166e1db8c"

timestamp

String <Date-Time>

Required

RFC 3339 timestamp indicating when the evaluation request was initiated by your system.

"2025-05-02T12:44:22.059Z"

workflow

String

Required

Your environment-specific workflow identifier. You can find this value in the RiskOS™ Dashboard > Developer Workbench > Integration Checklist.

"consumer_onboarding"

data

Object

Required

Main payload containing consumer information, device data, and event details for evaluation.

→individual

Object

Required

Primary identity object containing individual's information.

See individual schema below.


individual fields

FieldTypeRequiredDescriptionExample
idStringOptionalMaps to the userId in enrichments or a customer’s internal identifier. Can be enabled as a searchable field in RiskOS™ Dashboard."username"
given_nameStringRequiredConsumer's first/given name (max 240 characters)."Franky"
family_nameStringRequiredConsumer's last/family name (max 240 characters)."Valley"
emailStringRequiredConsumer's email address (must be a valid email format)"[email protected]"
phone_numberStringRequiredConsumer's phone number with country code. E.164 format preferred for best results."+1-667-368-1976"
national_idStringRequiredNational identifier such as SSN, SIN, or equivalent, depending on geography."555667772"
date_of_birthStringRequiredConsumer's date of birth in ISO 8601 format (YYYY-MM-DD)."1992-03-11"
addressObjectOptionalConsumer's mailing address used for identity verification and geographic risk assessment.See address schema below.
di_session_tokenString (UUID)RequiredToken from the Digital Intelligence SDK that links the device session."eyJraWQiOi_di_token"
additional_contextObjectRequiredDisclosure or consent metadata for products such as Sigma First-Party Fraud.See additional_context schema below.
docvObjectRequired (if using Predictive DocV)Configuration object for Document Verification. Defines message delivery, language, and use-case options.See docv schema below.

address fields

FieldTypeRequiredDescriptionExample
line_1StringOptionalThe first line of the consumer's address."742 Evergreen Terrace"
line_2StringOptionalAn optional second line for the address, such as apartment number, suite, or building landmarks."Apt 2B"
localityStringOptionalCity, town, or village name where the consumer resides."Springfield"
major_admin_divisionStringOptionalThe state, province, or region where the consumer resides."IL"
countryStringOptionalThe country where the consumer resides, specified in ISO 3166-1 alpha-2 country code for international address standardization."US"
postal_codeStringOptionalThe consumer's ZIP code, postal code, or equivalent regional identifier for mail delivery."62704"

additional_context fields

FieldTypeRequiredDescriptionExample
disclosure_purposeStringRequiredDisclosure for running Sigma First-Party Fraud product."GLBA_502(e)"

docv fields (only required when using Predictive DocV in your workflow)

FieldTypeRequiredDescriptionExample
transaction_tokenStringConditionalThe transaction token from the Document Request API response (v5). Use this if integrated with Socure's DocV solution."1e89eec0-f7a3-4210-b74b-a76bc9556c50"
configObjectOptionalConfiguration options controlling Capture App behavior and document verification flow for a given transaction.See config schema below.
→ send_messageBooleanOptionalSet to true to send an SMS to the provided phone number with the document request URL. Defaults to false.

- US & Canada: sent from short code 33436
- Other countries: sent from +1 (510) 330-19xx		true
→ languageStringOptionalDetermines Capture App UI language. Defaults to en-us."en-us"
→ use_case_keyStringOptionalDeploys a specific Capture App flow created in RiskOS™. Defaults to the account’s default flow or the flow configured in the RiskOS™ workflow."default_capture_flow"
→ redirectObjectOptionalObject containing post-capture redirect behavior.See redirect schema below.
→ redirect.methodStringConditionalRequired if redirect is provided. Accepts GET or POST."POST"
→ redirect.urlStringConditionalRequired if redirect is provided. The destination URL to send the consumer after capture. Can include query strings for transaction tracking."https://example.com/docv"
→ document_typeStringOptionalRestrict to a single document type (license or passport) for a simplified flow. Users skip the document type selection screen when passed."license"
→ transaction_tokenStringOptionalUsed primarily in Sandbox testing to indicate the expected decision outcome. Required when simulating test results."sandbox-simulated-pass"

external_device fields - Optional

Use these fields when integrating device data from third-party providers (if not using Socure Digital Intelligence).

FieldTypeDescriptionExample
idStringUnique customer-side identifier for the device across sessions."device-abc123"
sessionStringUnique identifier for the current device session."session-xyz789"
fingerprintStringDevice fingerprint from your third-party provider."fp-unique-identifier"
fingerprint_providerStringName of the fingerprint provider generating the device data."FingerprintJS"
user_agentStringComplete user agent string from the device browser or app."Mozilla/5.0 (iPhone; CPU iPhone OS..."
device_typeStringType of device being used for the session.
One of mobile, desktop, or tablet.		"mobile"
is_knownBooleanIndicates whether this device has been seen before by your system.true
first_seen_timeString <Date-Time>RFC 3339 timestamp when this device was first encountered."2023-10-01T10:00:00.000Z"
last_seen_timeString <Date-Time>RFC 3339 timestamp when this device was most recently seen."2023-12-01T15:30:00.000Z"
timezone_mismatchBooleanIndicates whether the device timezone differs from the expected location.false
ip_addressStringCurrent IP address of the device."203.0.113.10"
is_ip_bad_proxyBooleanIndicates whether the IP is associated with known malicious proxy services.false
is_ip_proxyBooleanIndicates whether the IP address is identified as any type of proxy.true
ip_risk_scoreNumber <Float>Risk score (0–100) associated with the device’s IP address.25.7
ip_ispStringInternet service provider name for the device’s IP."Comcast Cable"
ip_country_codeStringISO 3166-1 alpha-2 country code for the IP address location."US"
ip_cityStringCity name associated with the IP address geolocation."Chicago"
ip_regionStringState or region name for the IP address location."Illinois"
is_ip_torBooleanIndicates whether the IP address is associated with Tor network traffic.false
is_emulatorBooleanIndicates whether the device is identified as an emulator or virtual device.false

Example response

When you call the Evaluation API, RiskOS™ returns a JSON payload that includes the final decision, evaluation metadata, and enrichment-specific results produced by your Consumer Onboarding workflow.

{
  "id": "895dc35b-cee7-4f14-af06-6e26482178f8",
  "workflow": "consumer_onboarding",
  "workflow_id": "8b93f74b-7273-410c-a16e-b2ad14613f11",
  "workflow_version": "2.6.0",
  "eval_source": "API",
  "eval_id": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
  "eval_start_time": "2025-12-11T17:49:28.529047165Z",
  "eval_end_time": "2025-12-11T17:49:28.931231288Z",
  "decision": "ACCEPT",
  "decision_at": "2025-12-11T17:49:28.930983809Z",
  "status": "CLOSED",
  "sub_status": "Accept",
  "tags": [],
  "notes": "",
  "review_queues": [],
  "data_enrichments": [
    {
      "enrichment_name": "Socure Digital Intelligence",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "deviceSessionId": "eyJraWQiOi_di_token",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "digitalintelligence"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "digitalIntelligence": {
          "behavioral": {
            "aggregations": {
              "blurCount": 3,
              "clickCount": 3,
              "focusCount": 0,
              "inputChangeCount": 6,
              "pasteCount": 0,
              "submissionCount": 1,
              "totalEventCount": 26
            },
            "duration": 120910,
            "serverCreated": "2021-09-01T11:19:58.796Z",
            "serverUpdated": "2021-09-11T16:19:58.796Z",
            "sessionId": "d34304a6-a726-4dec-b1cd-9c4a3c192a0d",
            "source": "https://example.com/"
          },
          "device": {
            "attributes": {
              "androidAttributes": {
                "isRooted": false,
                "mobileNetwork": [
                  {
                    "carrierName": "T-Mobile",
                    "isoCountryCode": "us"
                  }
                ]
              },
              "battery": {
                "batteryLevel": 0.47,
                "batteryState": "charging"
              },
              "deviceContext": "homepage",
              "deviceManufacturer": "Apple",
              "deviceModel": "iphone14,7",
              "devicePixelRatio": 1.5,
              "deviceType": "tablet",
              "iOSAttributes": {
                "isRooted": false,
                "mobileNetwork": [
                  {
                    "carrierName": "T-Mobile",
                    "isoCountryCode": "us"
                  }
                ]
              },
              "isEmulator": false,
              "language": "en-US",
              "location": {
                "altitude": 998.2,
                "bearing": 32,
                "bearingAccuracy": 2.1,
                "horizontalAccuracy": 2.1,
                "latitude": 41.50854591662628,
                "longitude": -81.69534315646631,
                "speed": 1.3,
                "speedAccuracy": 0.2,
                "verticalAccuracy": 0
              },
              "network": {
                "vpnStatus": true
              },
              "os": "iOS",
              "osVersion": "17",
              "platform": "iOS",
              "screenHeight": 1080,
              "screenWidth": 1920,
              "sdkVersion": "3.0.1",
              "timeZone": "America/New_York",
              "timeZoneOffset": -480,
              "viewportHeight": 400,
              "viewportWidth": 600,
              "webAttributes": {
                "browser": "Google Chrome",
                "browserVersion": "116",
                "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/21A5291h [FBAN/FBIOS;FBDV/iPhone15,3;FBMD/iPhone;FBSN/iOS;FBSV/17.0;FBSS/3;FBID/phone;FBLC/fr_FR;FBOP/5]",
                "userAgentExtractionRequired": true
              }
            },
            "computed": {
              "isVirtualMachine": false,
              "statisticalId": "9349d69fef75cd356744293487462f8cd912"
            },
            "deviceCaptureAt": "2023-10-24T15:55:17.368756891Z",
            "history": {
              "daysSeen": [
                "2023-10-24"
              ],
              "firstSeen": "2023-10-24T15:55:16.368Z",
              "ips": [
                "78.32.11.221",
                "70.45.2.1"
              ],
              "isps": [
                "RogersCable",
                "T-Mobile"
              ],
              "lastSeen": "2023-10-24T15:55:16.368Z",
              "networkLocations": [
                "chicago, il",
                "new york, ny",
                "paris, fr"
              ]
            },
            "id": "234ac3ff-3ed1-42de-8f33-8f332febfa54",
            "network": {
              "asn": 27364,
              "asnName": "armstrong",
              "connectionIp": "38.48.122.126",
              "domainName": "zoominternet.net",
              "forwardedForIps": [
                "78.32.11.221",
                "70.45.2.1"
              ],
              "isConsumerPrivacy": false,
              "isMobileCarrier": true,
              "isProxy": false,
              "isRiskyNetwork": false,
              "isTor": false,
              "isVpn": false,
              "isp": "comcast",
              "ispType": "home",
              "networkLocation": {
                "city": "Tacoma",
                "continentCode": "na",
                "countryCode": "US",
                "gmtOffset": "-0400",
                "latitude": 47.2529001,
                "longitude": -122.4443,
                "metroCode": 819,
                "postalCode": "98401",
                "region": "WA",
                "timezoneName": "America/New_York"
              },
              "org": "comcast",
              "realIp": "38.48.122.126",
              "speed": "cable",
              "webRtcInternalIp": "192.168.1.85",
              "webRtcPublicIp": "176.124.54.12"
            },
            "sessionCreatedAt": "2023-10-24T15:55:16.368492137Z"
          },
          "velocityMetrics": {
            "historicalCount": {
              "email": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "firstName": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "lastName": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "mobileNumber": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              }
            }
          }
        },
        "referenceId": "ec2fb84f-81b5-4421-a4a6-ac070b874f46"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Phone Risk",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "phonerisk"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "namePhoneCorrelation": {
          "reasonCodes": [
            "I622",
            "I621",
            "I618"
          ],
          "score": 0.99
        },
        "phoneRisk": {
          "reasonCodes": [
            "I609",
            "I618",
            "I608"
          ],
          "scores": [
            {
              "name": "RiskPhoneUS.V7__Uniform.V1",
              "score": 0.01,
              "version": "4.0"
            }
          ]
        },
        "referenceId": "fd9e43dc-8a7b-4819-9f0f-eb79401dc795"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure OTP - static accept",
      "enrichment_endpoint": "https://mockserver.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "RestAPI",
      "status_code": 200,
      "response": {
        "attemptCount": 1,
        "error": "",
        "status": "accept",
        "verificationId": "10901fa6-bf0a-441a-8190-7cd109dbab65"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Verify Plus",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "kycplus"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "kycPlus": {
          "bestMatchedEntity": {
            "associatedAddresses": [],
            "associatedEmails": [],
            "associatedPhoneNumbers": [],
            "dob": "",
            "emailAddress": "",
            "firstName": "",
            "middleName": "",
            "mobileNumber": "",
            "normalizedAddress": {
              "city": "Springfield",
              "state": "IL",
              "streetAddress": "742 Evergreen Terrace",
              "zip": "62704"
            },
            "ssn": "",
            "ssnIssued": "",
            "suffix": "",
            "surName": ""
          },
          "fieldValidations": {
            "city": 0.99,
            "dob": 0.99,
            "email": 0.99,
            "firstName": 0.99,
            "mobileNumber": 0.99,
            "ssn": 0.99,
            "state": 0.99,
            "streetAddress": 0.99,
            "surName": 0.99,
            "zip": 0.99
          },
          "reasonCodes": [
            "I919"
          ],
          "socureId": "0318d3c3-541c-4090-8250-dec3e41efa89",
          "sourceAttribution": [
            "Alternative Credit",
            "County Tax"
          ]
        },
        "referenceId": "aa96eebe-7ae8-446f-837d-df36e704aa9c"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Sigma Synthetic",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "synthetic"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "referenceId": "4615f59b-51c6-45de-84e5-47bfa2d5c546",
        "synthetic": {
          "reasonCodes": [
            "I204",
            "R223",
            "I206"
          ],
          "scores": [
            {
              "name": "synthetic",
              "score": 0.127,
              "version": "4.1"
            }
          ]
        }
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Email Risk",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "emailrisk"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "emailRisk": {
          "reasonCodes": [
            "I553",
            "I555",
            "I556"
          ],
          "scores": [
            {
              "name": "RiskEmailUS.V11__Uniform.V1",
              "score": 0.01,
              "version": "4.0"
            }
          ]
        },
        "nameEmailCorrelation": {
          "reasonCodes": [
            "I557",
            "I556",
            "I558"
          ],
          "score": 0.99
        },
        "referenceId": "02ed96ca-8fb3-4101-9b52-2590eeb676c9"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Address Risk",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "addressrisk"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "addressRisk": {
          "reasonCodes": [
            "I720",
            "I705",
            "I708"
          ],
          "scores": [
            {
              "name": "RiskAddressNOIPUS.V8__Uniform.V1",
              "score": 0.01,
              "version": "4.0"
            }
          ]
        },
        "customerProfile": {
          "userId": "username"
        },
        "nameAddressCorrelation": {
          "reasonCodes": [
            "I709",
            "I708",
            "I710"
          ],
          "score": 0.99
        },
        "referenceId": "2032ad44-b0ae-4bde-a9dd-51285b27ed92"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure GraphIntelligence + Sigma Fraud",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "graphintelligence",
          "fraud"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "fraud": {
          "reasonCodes": [
            "I641",
            "I555",
            "I576",
            "I602"
          ],
          "scores": [
            {
              "name": "sigma",
              "score": 0.11,
              "version": "4.0"
            }
          ]
        },
        "graphIntelligence": {
          // Socure returns additional raw address signals not shown here for brevity and sensitivity.
        },
        "referenceId": "d4c0e92f-cc57-449e-adad-4e0b67b782a8"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure First Party Fraud",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "disclosurePurpose": "GLBA_502(e)",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "firstpartyfraud"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "firstPartyFraud": {
          "reasonCodes": [],
          "scores": [
            {
              "name": "Identity Manipulation",
              "score": 0.14,
              "version": "1.0"
            }
          ],
          "signals": {
            // Socure returns additional raw address signals not shown here for brevity and sensitivity.
          }
        },
        "referenceId": "2a4c212c-3169-4f97-b0de-08526e5dffca"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Global Watchlist Plus",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "country": "US",
        "dob": "1992-03-11",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": [
          "watchlistplus"
        ],
        "nationalId": "435960859",
        "parentTxnId": "b1c0e610-822d-4793-a970-8bfc0a9b883f",
        "physicalAddress": "742 Evergreen Terrace",
        "physicalAddress2": "Apt 2B",
        "riskOSId": "895dc35b-cee7-4f14-af06-6e26482178f8",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "globalWatchlist": {
          "matches": {},
          "reasonCodes": [
            "I196"
          ]
        },
        "referenceId": "1ac4f38a-60cd-4cbe-8b66-111ba43f4d47"
      },
      "is_source_cache": false,
      "total_attempts": 1
    }
  ],
  "eval_status": "evaluation_completed",
  "score": 11,
  "environment_name": "Sandbox"
}

{
  "id": "4c5510af-a397-4430-b628-c952977b6c1f",
  "workflow": "consumer_onboarding",
  "workflow_id": "8b93f74b-7273-410c-a16e-b2ad14613f11",
  "workflow_version": "2.6.0",
  "eval_source": "API",
  "eval_id": "35bccdd5-e285-4988-b4e2-f9b55602b4a3",
  "eval_start_time": "2025-12-12T14:42:12.738920438Z",
  "eval_end_time": "2025-12-12T14:42:13.494653846Z",
  "decision": "REVIEW",
  "decision_at": "2025-12-12T14:42:13.494374036Z",
  "status": "OPEN",
  "sub_status": "In Review",
  "tags": [
    "Watchlist Review"
  ],
  "notes": "",
  "review_queues": [
    "Compliance"
  ],
  "data_enrichments": [
    {
      "enrichment_name": "Socure Digital Intelligence",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "FPO",
        "country": "US",
        "deviceSessionId": "eyJraWQiOiJmMzRiN2YiLCJh_DI_LOW_SCORE",
        "dob": "1999-02-06",
        "email": "[email protected]",
        "firstName": "Carl",
        "ipAddress": "183.119.136.106",
        "mobileNumber": "+116787345437",
        "modules": [
          "digitalintelligence"
        ],
        "nationalId": "590618849",
        "parentTxnId": "35bccdd5-e285-4988-b4e2-f9b55602b4a3",
        "physicalAddress": "USNS Collins",
        "physicalAddress2": "Unit 7",
        "riskOSId": "4c5510af-a397-4430-b628-c952977b6c1f",
        "state": "AA",
        "surName": "Sell",
        "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3",
        "workflow": "consumer_onboarding",
        "zip": "98765"
      },
      "response": {
        "customerProfile": {
          "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3"
        },
        "digitalIntelligence": {
          "behavioral": {
            "aggregations": {
              "blurCount": 3,
              "clickCount": 3,
              "focusCount": 0,
              "inputChangeCount": 6,
              "pasteCount": 0,
              "submissionCount": 1,
              "totalEventCount": 26
            },
            "duration": 120910,
            "serverCreated": "2021-09-01T11:19:58.796Z",
            "serverUpdated": "2021-09-11T16:19:58.796Z",
            "sessionId": "d34304a6-a726-4dec-b1cd-9c4a3c192a0d",
            "source": "https://example.com/"
          },
          "device": {
            "attributes": {
              "androidAttributes": {
                "isRooted": false,
                "mobileNetwork": [
                  {
                    "carrierName": "T-Mobile",
                    "isoCountryCode": "us"
                  }
                ]
              },
              "battery": {
                "batteryLevel": 0.47,
                "batteryState": "charging"
              },
              "deviceContext": "homepage",
              "deviceManufacturer": "Apple",
              "deviceModel": "iphone14,7",
              "devicePixelRatio": 1.5,
              "deviceType": "tablet",
              "iOSAttributes": {
                "isRooted": false,
                "mobileNetwork": [
                  {
                    "carrierName": "T-Mobile",
                    "isoCountryCode": "us"
                  }
                ]
              },
              "isEmulator": false,
              "language": "en-US",
              "location": {
                "altitude": 998.2,
                "bearing": 32,
                "bearingAccuracy": 2.1,
                "horizontalAccuracy": 2.1,
                "latitude": 41.50854591662628,
                "longitude": -81.69534315646631,
                "speed": 1.3,
                "speedAccuracy": 0.2,
                "verticalAccuracy": 0
              },
              "network": {
                "vpnStatus": true
              },
              "os": "iOS",
              "osVersion": "17",
              "platform": "iOS",
              "screenHeight": 1080,
              "screenWidth": 1920,
              "sdkVersion": "3.0.1",
              "timeZone": "America/New_York",
              "timeZoneOffset": -480,
              "viewportHeight": 400,
              "viewportWidth": 600,
              "webAttributes": {
                "browser": "Google Chrome",
                "browserVersion": "116",
                "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/21A5291h [FBAN/FBIOS;FBDV/iPhone15,3;FBMD/iPhone;FBSN/iOS;FBSV/17.0;FBSS/3;FBID/phone;FBLC/fr_FR;FBOP/5]",
                "userAgentExtractionRequired": true
              }
            },
            "computed": {
              "isVirtualMachine": false,
              "statisticalId": "9349d69fef75cd356744293487462f8cd912"
            },
            "deviceCaptureAt": "2023-10-24T15:55:17.368756891Z",
            "history": {
              "daysSeen": [
                "2023-10-24"
              ],
              "firstSeen": "2023-10-24T15:55:16.368Z",
              "ips": [
                "78.32.11.221",
                "70.45.2.1"
              ],
              "isps": [
                "RogersCable",
                "T-Mobile"
              ],
              "lastSeen": "2023-10-24T15:55:16.368Z",
              "networkLocations": [
                "chicago, il",
                "new york, ny",
                "paris, fr"
              ]
            },
            "id": "234ac3ff-3ed1-42de-8f33-8f332febfa54",
            "network": {
              "asn": 27364,
              "asnName": "armstrong",
              "connectionIp": "38.48.122.126",
              "domainName": "zoominternet.net",
              "forwardedForIps": [
                "78.32.11.221",
                "70.45.2.1"
              ],
              "isConsumerPrivacy": false,
              "isMobileCarrier": true,
              "isProxy": false,
              "isRiskyNetwork": false,
              "isTor": false,
              "isVpn": false,
              "isp": "comcast",
              "ispType": "home",
              "networkLocation": {
                "city": "Tacoma",
                "continentCode": "na",
                "countryCode": "US",
                "gmtOffset": "-0400",
                "latitude": 47.2529001,
                "longitude": -122.4443,
                "metroCode": 819,
                "postalCode": "98401",
                "region": "WA",
                "timezoneName": "America/New_York"
              },
              "org": "comcast",
              "realIp": "38.48.122.126",
              "speed": "cable",
              "webRtcInternalIp": "192.168.1.85",
              "webRtcPublicIp": "176.124.54.12"
            },
            "sessionCreatedAt": "2023-10-24T15:55:16.368492137Z"
          },
          "velocityMetrics": {
            "historicalCount": {
              "email": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "firstName": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "lastName": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "mobileNumber": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              }
            }
          }
        },
        "referenceId": "c696cfb6-46b8-4db1-b6dc-8cdf1cd1161a"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Phone Risk",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "FPO",
        "country": "US",
        "dob": "1999-02-06",
        "email": "[email protected]",
        "firstName": "Carl",
        "ipAddress": "183.119.136.106",
        "mobileNumber": "+116787345437",
        "modules": [
          "phonerisk"
        ],
        "nationalId": "590618849",
        "parentTxnId": "35bccdd5-e285-4988-b4e2-f9b55602b4a3",
        "physicalAddress": "USNS Collins",
        "physicalAddress2": "Unit 7",
        "riskOSId": "4c5510af-a397-4430-b628-c952977b6c1f",
        "state": "AA",
        "surName": "Sell",
        "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3",
        "workflow": "consumer_onboarding",
        "zip": "98765"
      },
      "response": {
        "customerProfile": {
          "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3"
        },
        "namePhoneCorrelation": {
          "reasonCodes": [
            "I618",
            "I621",
            "I622"
          ],
          "score": 0.99
        },
        "phoneRisk": {
          "reasonCodes": [
            "I614",
            "I609"
          ],
          "scores": [
            {
              "name": "RiskPhoneUS.V7__Uniform.V1",
              "score": 0.01,
              "version": "4.0"
            }
          ]
        },
        "referenceId": "30c8542a-7b5e-4e54-a710-c91e4990e58b"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure OTP - static accept",
      "enrichment_endpoint": "https://mockserver.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "RestAPI",
      "status_code": 200,
      "response": {
        "attemptCount": 1,
        "error": "",
        "status": "accept",
        "verificationId": "10901fa6-bf0a-441a-8190-7cd109dbab65"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Verify Plus",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "FPO",
        "country": "US",
        "dob": "1999-02-06",
        "email": "[email protected]",
        "firstName": "Carl",
        "ipAddress": "183.119.136.106",
        "mobileNumber": "+116787345437",
        "modules": [
          "kycplus"
        ],
        "nationalId": "590618849",
        "parentTxnId": "35bccdd5-e285-4988-b4e2-f9b55602b4a3",
        "physicalAddress": "USNS Collins",
        "physicalAddress2": "Unit 7",
        "riskOSId": "4c5510af-a397-4430-b628-c952977b6c1f",
        "state": "AA",
        "surName": "Sell",
        "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3",
        "workflow": "consumer_onboarding",
        "zip": "98765"
      },
      "response": {
        "customerProfile": {
          "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3"
        },
        "kycPlus": {
          "bestMatchedEntity": {
            "associatedAddresses": [],
            "associatedEmails": [],
            "associatedPhoneNumbers": [],
            "dob": "",
            "emailAddress": "",
            "firstName": "",
            "middleName": "",
            "mobileNumber": "",
            "normalizedAddress": {
              "city": "FPO",
              "state": "AA",
              "streetAddress": "USNS Collins",
              "zip": "98765"
            },
            "ssn": "",
            "ssnIssued": "",
            "suffix": "",
            "surName": ""
          },
          "fieldValidations": {
            "city": 0.99,
            "dob": 0.99,
            "email": 0.99,
            "firstName": 0.99,
            "mobileNumber": 0.99,
            "ssn": 0.99,
            "state": 0.99,
            "streetAddress": 0.99,
            "surName": 0.99,
            "zip": 0.99
          },
          "reasonCodes": [
            "I919"
          ],
          "socureId": "0318d3c3-541c-4090-8250-dec3e41efa89",
          "sourceAttribution": [
            "Alternative Credit",
            "County Tax"
          ]
        },
        "referenceId": "c8c69abe-772b-448a-abb0-64ea8b0bed29"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Sigma Synthetic",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "FPO",
        "country": "US",
        "dob": "1999-02-06",
        "email": "[email protected]",
        "firstName": "Carl",
        "ipAddress": "183.119.136.106",
        "mobileNumber": "+116787345437",
        "modules": [
          "synthetic"
        ],
        "nationalId": "590618849",
        "parentTxnId": "35bccdd5-e285-4988-b4e2-f9b55602b4a3",
        "physicalAddress": "USNS Collins",
        "physicalAddress2": "Unit 7",
        "riskOSId": "4c5510af-a397-4430-b628-c952977b6c1f",
        "state": "AA",
        "surName": "Sell",
        "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3",
        "workflow": "consumer_onboarding",
        "zip": "98765"
      },
      "response": {
        "customerProfile": {
          "userId": "ANALYSTDEMO_IDPLUS-9109_SCENARIO_3"
        },
        "referenceId": "ae5eb95d-ea79-4458-b863-703a0e263cde",
        "synthetic": {
          "reasonCodes": [
            "I206",
            "R224",
            "I207"
          ],
          "scores": [
            {
              "name": "synthetic",
              "score": 0.158,
              "version": "4.1"

{
  "id": "53692841-4add-47d9-94b6-023f3ec59f79",
  "workflow": "consumer_onboarding",
  "workflow_id": "8b93f74b-7273-410c-a16e-b2ad14613f11",
  "workflow_version": "2.6.0",
  "eval_source": "API",
  "eval_id": "8024151f-7677-4b18-80cb-d987b4ec933a",
  "eval_start_time": "2025-12-12T14:46:35.123499275Z",
  "eval_end_time": "2025-12-12T14:46:36.198301845Z",
  "decision": "REJECT",
  "decision_at": "2025-12-12T14:46:36.198147615Z",
  "status": "CLOSED",
  "sub_status": "Reject",
  "tags": [
    "Synthetic Fraud - High Risk"
  ],
  "notes": "",
  "review_queues": [],
  "data_enrichments": [
    {
      "enrichment_name": "Socure Digital Intelligence",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "deviceSessionId": "eyJraWQi_DI_LOW_SCORE",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "digitalintelligence"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "customerProfile": {
          "userId": "ANY"
        },
        "digitalIntelligence": {
          "behavioral": {
            "aggregations": {
              "blurCount": 3,
              "clickCount": 3,
              "focusCount": 0,
              "inputChangeCount": 6,
              "pasteCount": 0,
              "submissionCount": 1,
              "totalEventCount": 26
            },
            "duration": 120910,
            "serverCreated": "2021-09-01T11:19:58.796Z",
            "serverUpdated": "2021-09-11T16:19:58.796Z",
            "sessionId": "d34304a6-a726-4dec-b1cd-9c4a3c192a0d",
            "source": "https://example.com/"
          },
          "device": {
            "attributes": {
              "androidAttributes": {
                "isRooted": false,
                "mobileNetwork": [
                  {
                    "carrierName": "T-Mobile",
                    "isoCountryCode": "us"
                  }
                ]
              },
              "battery": {
                "batteryLevel": 0.47,
                "batteryState": "charging"
              },
              "deviceContext": "homepage",
              "deviceManufacturer": "Apple",
              "deviceModel": "iphone14,7",
              "devicePixelRatio": 1.5,
              "deviceType": "tablet",
              "iOSAttributes": {
                "isRooted": false,
                "mobileNetwork": [
                  {
                    "carrierName": "T-Mobile",
                    "isoCountryCode": "us"
                  }
                ]
              },
              "isEmulator": false,
              "language": "en-US",
              "location": {
                "altitude": 998.2,
                "bearing": 32,
                "bearingAccuracy": 2.1,
                "horizontalAccuracy": 2.1,
                "latitude": 41.50854591662628,
                "longitude": -81.69534315646631,
                "speed": 1.3,
                "speedAccuracy": 0.2,
                "verticalAccuracy": 0
              },
              "network": {
                "vpnStatus": true
              },
              "os": "iOS",
              "osVersion": "17",
              "platform": "iOS",
              "screenHeight": 1080,
              "screenWidth": 1920,
              "sdkVersion": "3.0.1",
              "timeZone": "America/New_York",
              "timeZoneOffset": -480,
              "viewportHeight": 400,
              "viewportWidth": 600,
              "webAttributes": {
                "browser": "Google Chrome",
                "browserVersion": "116",
                "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/21A5291h [FBAN/FBIOS;FBDV/iPhone15,3;FBMD/iPhone;FBSN/iOS;FBSV/17.0;FBSS/3;FBID/phone;FBLC/fr_FR;FBOP/5]",
                "userAgentExtractionRequired": true
              }
            },
            "computed": {
              "isVirtualMachine": false,
              "statisticalId": "9349d69fef75cd356744293487462f8cd912"
            },
            "deviceCaptureAt": "2023-10-24T15:55:17.368756891Z",
            "history": {
              "daysSeen": [
                "2023-10-24"
              ],
              "firstSeen": "2023-10-24T15:55:16.368Z",
              "ips": [
                "78.32.11.221",
                "70.45.2.1"
              ],
              "isps": [
                "RogersCable",
                "T-Mobile"
              ],
              "lastSeen": "2023-10-24T15:55:16.368Z",
              "networkLocations": [
                "chicago, il",
                "new york, ny",
                "paris, fr"
              ]
            },
            "id": "234ac3ff-3ed1-42de-8f33-8f332febfa54",
            "network": {
              "asn": 27364,
              "asnName": "armstrong",
              "connectionIp": "38.48.122.126",
              "domainName": "zoominternet.net",
              "forwardedForIps": [
                "78.32.11.221",
                "70.45.2.1"
              ],
              "isConsumerPrivacy": false,
              "isMobileCarrier": true,
              "isProxy": false,
              "isRiskyNetwork": false,
              "isTor": false,
              "isVpn": false,
              "isp": "comcast",
              "ispType": "home",
              "networkLocation": {
                "city": "Tacoma",
                "continentCode": "na",
                "countryCode": "US",
                "gmtOffset": "-0400",
                "latitude": 47.2529001,
                "longitude": -122.4443,
                "metroCode": 819,
                "postalCode": "98401",
                "region": "WA",
                "timezoneName": "America/New_York"
              },
              "org": "comcast",
              "realIp": "38.48.122.126",
              "speed": "cable",
              "webRtcInternalIp": "192.168.1.85",
              "webRtcPublicIp": "176.124.54.12"
            },
            "sessionCreatedAt": "2023-10-24T15:55:16.368492137Z"
          },
          "velocityMetrics": {
            "historicalCount": {
              "email": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "firstName": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "lastName": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              },
              "mobileNumber": {
                "uniqueCount": 3,
                "uniqueSharePercent": 50
              }
            }
          }
        },
        "referenceId": "c7eeb803-41d5-46da-8dec-afb65891a243"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Phone Risk",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "phonerisk"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "customerProfile": {
          "userId": "ANY"
        },
        "namePhoneCorrelation": {
          "reasonCodes": [
            "I621",
            "I622",
            "I618"
          ],
          "score": 0.99
        },
        "phoneRisk": {
          "reasonCodes": [
            "I601",
            "I602",
            "I614"
          ],
          "scores": [
            {
              "name": "RiskPhoneUS.V7__Uniform.V1",
              "score": 0.01,
              "version": "4.0"
            }
          ]
        },
        "referenceId": "a2e60f1a-f656-4726-89d4-7c4c3994b765"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure OTP - static accept",
      "enrichment_endpoint": "https://mockserver.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "RestAPI",
      "status_code": 200,
      "response": {
        "attemptCount": 1,
        "error": "",
        "status": "accept",
        "verificationId": "10901fa6-bf0a-441a-8190-7cd109dbab65"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Verify Plus",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "kycplus"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "customerProfile": {
          "userId": "ANY"
        },
        "kycPlus": {
          "bestMatchedEntity": {
            "associatedAddresses": [],
            "associatedEmails": [],
            "associatedPhoneNumbers": [],
            "dob": "",
            "emailAddress": "",
            "firstName": "",
            "middleName": "",
            "mobileNumber": "",
            "normalizedAddress": {
              "city": "Piscataway",
              "state": "NJ",
              "streetAddress": "52032 Davis Fort",
              "zip": "08854"
            },
            "ssn": "",
            "ssnIssued": "",
            "suffix": "",
            "surName": ""
          },
          "fieldValidations": {
            "city": 0.99,
            "dob": 0.99,
            "email": 0.99,
            "firstName": 0.99,
            "mobileNumber": 0.99,
            "ssn": 0.99,
            "state": 0.99,
            "streetAddress": 0.99,
            "surName": 0.99,
            "zip": 0.99
          },
          "reasonCodes": [
            "I919"
          ],
          "socureId": "0318d3c3-541c-4090-8250-dec3e41efa89",
          "sourceAttribution": [
            "Alternative Credit",
            "County Tax"
          ]
        },
        "referenceId": "82c7d304-d9ed-4ca3-b124-81743fd6ae42"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Sigma Synthetic",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "synthetic"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "customerProfile": {
          "userId": "ANY"
        },
        "referenceId": "d600c00e-bbc1-41c0-9a50-374563dad783",
        "synthetic": {
          "reasonCodes": [
            "R606",
            "R224",
            "R216",
            "I568",
            "R203",
            "R703",
            "I708",
            "R219",
            "I569",
            "R208",
            "R223",
            "R615",
            "R299",
            "I570"
          ],
          "scores": [
            {
              "name": "synthetic",
              "score": 0.995,
              "version": "4.1"
            }
          ]
        }
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure eCBSV Explicit",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 403,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "ecbsv"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "response": "{\"status\":\"Error\",\"referenceId\":\"64a90c05-0278-40b1-a712-152efdd280db\",\"data\":{\"permissions\":[\"ECBSV\"]},\"customerProfile\":{\"userId\":\"ANY\"},\"msg\":\"The API key isn't provisioned to serve the request.\"}"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Email Risk",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "emailrisk"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "customerProfile": {
          "userId": "ANY"
        },
        "emailRisk": {
          "reasonCodes": [
            "I556",
            "I553",
            "I520"
          ],
          "scores": [
            {
              "name": "RiskEmailUS.V11__Uniform.V1",
              "score": 0.01,
              "version": "4.0"
            }
          ]
        },
        "nameEmailCorrelation": {
          "reasonCodes": [
            "I556",
            "I557",
            "I558"
          ],
          "score": 0.99
        },
        "referenceId": "2668c253-b5ac-4121-a951-05c162b4684c"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Address Risk",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "addressrisk"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "addressRisk": {
          "reasonCodes": [
            "I708",
            "I705",
            "I704"
          ],
          "scores": [
            {
              "name": "RiskAddressNOIPUS.V8__Uniform.V1",
              "score": 0.01,
              "version": "4.0"
            }
          ]
        },
        "customerProfile": {
          "userId": "ANY"
        },
        "nameAddressCorrelation": {
          "reasonCodes": [
            "I710",
            "I709",
            "I708"
          ],
          "score": 0.99
        },
        "referenceId": "cb6137f8-de02-4837-9e63-844b2a1ee385"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure GraphIntelligence + Sigma Fraud",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "city": "Piscataway",
        "country": "US",
        "dob": "1974-09-07",
        "email": "[email protected]",
        "firstName": "Hope",
        "ipAddress": "242.103.177.99",
        "mobileNumber": "13471729423",
        "modules": [
          "graphintelligence",
          "fraud"
        ],
        "nationalId": "733842318",
        "parentTxnId": "8024151f-7677-4b18-80cb-d987b4ec933a",
        "physicalAddress": "52032 Davis Fort",
        "riskOSId": "53692841-4add-47d9-94b6-023f3ec59f79",
        "state": "NJ",
        "surName": "Lambert",
        "userId": "ANY",
        "workflow": "consumer_onboarding",
        "zip": "08854"
      },
      "response": {
        "customerProfile": {
          "userId": "ANY"
        },
        "fraud": {
          "reasonCodes": [
            "I553",
            "I121",
            "I127"
          ],
          "scores": [
            {
              "name": "sigma",
              "score": 0.43,
              "version": "4.0"
            }
          ]
        },
        "graphIntelligence": {
          // Socure returns additional raw address signals not shown here for brevity and sensitivity.       
        },
        "referenceId": "a321b9f8-f115-4e23-8fee-12daa073b256"
      },
      "is_source_cache": false,
      "total_attempts": 1
    }
  ],
  "eval_status": "evaluation_completed",
  "score": 11,
  "environment_name": "Sandbox"
}

Key response fields

RiskOS™ returns a consistent set of top-level fields that describe the outcome of an evaluation, along with enrichment outputs that depend on your workflow configuration.


Where to find specific results

AreaFieldsHow to use it
Decision and routingdecision, decision_at, tags, review_queues, notes, scorePrimary control signals. Branch application logic using decision. Use tags, queues, notes, and score for secondary routing, review, and explanation.
Module resultsModule-specific fields (for example: reasonCodes, scores, extracted attributes)Evidence and signals produced by workflow modules. Use for escalation, compliance review, investigation, and audit.
Identifiers and traceabilityid, eval_idPersist these identifiers to correlate API calls, logs, webhooks, GET requests, and support cases.
Enrichment executiondata_enrichments[] (response, status_code, total_attempts, is_source_cache)Inspect enrichment outputs and detect provisioning issues, partial failures, retries, or cached responses.
Workflow contextworkflow, workflow_id, workflow_versionUnderstand which workflow ran and which version produced the result. Useful for debugging and historical analysis.
Evaluation lifecycleeval_status, status, sub_statusExecution and case state only. Useful for monitoring and asynchronous workflows. Do not use for business decisions.
Execution contexteval_source, eval_start_time, eval_end_time, environment_nameObservability and performance metadata for latency tracking, environment validation, and API vs Dashboard attribution.

Decision and routing (primary control signals)

These fields describe the outcome of an evaluation and any routing applied by the workflow.

decision values are workflow-specific and may differ from the examples shown in this guide.

FieldTypeDescriptionExample
decisionString (enum)Final evaluation result.

Possible values:
• ACCEPT
• REVIEW
• REJECT
• RESUBMIT

Note: The fields returned can be customized to fit your integration or business needs.		"ACCEPT"
decision_atString <Date-Time>RFC 3339 timestamp when the decision was finalized."2025-12-11T17:49:28.930Z"
scoreNumberIf configured for a workflow, provides an aggregate score of all steps. This can be used for risk banding, additional routing, or analytics alongside the primary decision value.11
tagsArray of StringsArray of labels applied during the workflow to highlight routing choices, notable signals, or rule outcomes. Useful for reporting, segmentation, or UI highlighting in the RiskOS™ Dashboard.[]
review_queuesArray of StringsLists any manual review queues the evaluation was sent to. Empty when the case is fully auto-resolved without human review.[]
notesStringFreeform text field for analyst or system comments about the evaluation. Often used to capture manual review rationale or investigation context.""

Evaluation lifecycle and status

These fields describe where the evaluation is in its lifecycle and are useful for monitoring and asynchronous workflows.

FieldTypeDescriptionExample
eval_statusString (enum)Internal RiskOS™ evaluation lifecycle state.

Possible values:
• evaluation_completed
• evaluation_paused
• evaluation_in_progress		"evaluation_completed"
statusString (enum)Case-level status of the evaluation.

Possible values:
• OPEN
• CLOSED		"CLOSED"
sub_statusStringProvides additional detail about the evaluation status.

Example values:
• Under Review
• Pending Verification
• Accept
• Reject		"Accept"

Identifiers and traceability

Use these fields to correlate requests, logs, webhooks, and support cases.

FieldTypeDescriptionExample
idString (UUID or custom string)Your evaluation identifier within RiskOS™.

Note: This is customer-generated.		"895dc35b-cee7-4f14-af06-6e26482178f8"
eval_idString (UUID)RiskOS-generated unique identifier for the evaluation."b1c0e610-822d-4793-a970-8bfc0a9b883f"
workflowStringName of the workflow executed."consumer_onboarding"
workflow_idString (UUID)Unique identifier for the workflow run."8b93f74b-7273-410c-a16e-b2ad14613f11"
workflow_versionStringVersion of the executed workflow."2.6.0"

Execution context

These fields provide timing and environment context for the evaluation.

FieldTypeDescriptionExample
eval_sourceString (enum)Indicates where the evaluation was initiated from.

Possible values:
• API: Request submitted via the Evaluation API.
• Dashboard: Case created or evaluated through the RiskOS™ Dashboard.		"API"
eval_start_timeString <Date-Time>RFC 3339 timestamp for when RiskOS™ started processing the evaluation. Useful for latency and performance monitoring."2025-12-11T17:49:28.529Z"
eval_end_timeString <Date-Time>RFC 3339 timestamp for when RiskOS™ finished processing the evaluation. Can be paired with eval_start_time to compute total processing time."2025-12-11T17:49:28.931Z"
environment_nameStringIndicates which environment the evaluation ran in. Typically Sandbox for testing or Production for live traffic."Sandbox"

Enrichment results

Enrichment outputs are returned in the data_enrichments array. Each object corresponds to a module executed as part of the Consumer Onboarding workflow.

FieldTypeDescriptionExample
enrichment_nameStringName of the enrichment executed."Socure Digital Intelligence"
enrichment_providerStringProvider of the enrichment."Socure"
status_codeIntegerHTTP status returned by the enrichment call.200
requestObjectProvider request payload (for observability and debugging).See request schema below.
responseObjectNormalized enrichment response.See response schema below.
is_source_cacheBooleanIndicates whether cached data was used.false
total_attemptsIntegerNumber of attempts made to retrieve the data.1

Example request fields (varies by enrichment)

FieldTypeRequiredDescriptionExample
firstNameStringRequiredConsumer's first/given name submitted to the enrichment."Emily"
surNameStringRequiredConsumer's last/family name submitted to the enrichment."Brown"
nationalIdStringOptionalGovernment-issued identifier (e.g., SSN or National ID)."555667777"
dobString YYYY-MM-DDRequiredConsumer's date of birth used for KYC and verification."1992-03-15"
emailStringRequiredConsumer's email address."emily.brown.
[email protected]"
mobileNumberString (E.164)RequiredConsumer's phone number."16073680976"
cityStringOptionalCity, town, or village name where the consumer resides."Springfield"
stateStringOptionalThe state, province, or region where the consumer resides."IL"
zipStringOptionalThe consumer's ZIP code, postal code, or equivalent regional identifier for mail delivery."62704"
physicalAddressStringOptionalThe first line of the consumer's address."742 Evergreen Terrace"
physicalAddress2StringOptionalAn optional second line for the address, such as apartment number, suite, or building landmarks."Apt 2B"
countryStringOptionalThe country where the consumer resides, specified in ISO 3166-1 alpha-2 country code for international address standardization."US"
workflowStringRequiredWorkflow name for context routing."consumer_onboarding"
modulesArray of StringsRequiredList of RiskOS™ modules invoked in the enrichment call.["digitalintelligence"]
riskOSIdString (UUID)RequiredTransaction identifier linking this enrichment to the evaluation."cd9d9b8f-95a3
-41b0-bf55-7fa45628f763"
parentTxnIdString (UUID)RequiredParent evaluation transaction ID."de8438af-c78c-4f25-b850-5ba613ee140d"
userIdStringOptionalCustomer’s internal identifier for the applicant."username"

Example response fields (varies by enrichment)

FieldTypeDescriptionExample
customerProfileObjectCustomer profile information and identifiers associated with the evaluation.See customerProfile schema below.
digitalIntelligenceObjectComprehensive device and behavioral intelligence data from Socure's DI service.See Digital Intelligence.
fraudObjectFraud risk scores and reason codes indicating potential fraudulent activity patterns.See Sigma Identity Fraud.
syntheticObjectSynthetic identity detection scores and indicators for artificially created identities.See Sigma Synthetic Fraud.
phoneRiskObjectPhone number risk assessment including validation, carrier info, and risk indicators.See Phone Risk.
emailRiskObjectEmail address risk evaluation including domain analysis and reputation scoring.See Email Risk.
addressRiskObjectAddress validation and risk assessment including deliverability and fraud indicators.See Address Risk.
graphIntelligenceObjectNetwork analysis showing connections between identity elements across Socure's data graph.See Graph Intelligence.
referenceIdStringUnique identifier assigned to each enrichment after a RiskOS™ workflow is finalized."4b905868-9d20-4d1c-9fde-544aeede981f"

customerProfile fields

FieldTypeDescriptionExample
userIdStringCustomer-provided unique identifier for the individual being evaluated.`"09237

Asynchronous results: Final evaluation decision with Predictive DocV

If your Consumer Onboarding workflow includes the asynchronous step with Predictive DocV, this response is returned after the consumer completes the Capture App process and the workflow completes all remaining steps.

You can receive this response either through the evaluation_complete webhook or by sending a[GET request to the /api/evaluation/{eval_id} endpoint.

{
  "id": "a86580cc-1733-4188-86b5-717166e1db8c",
  "workflow": "consumer_onboarding",
  "workflow_id": "cdefa08b-5dce-4b0a-a87a-23693c01b5e5",
  "workflow_version": "4.36.0",
  "eval_source": "API",
  "eval_id": "1e85e088-ade0-4ef6-bb6d-3524da429114",
  "eval_start_time": "2025-09-25T16:43:39.984733153Z",
  "eval_end_time": "2025-09-25T16:48:11.028110755Z",
  "decision": "ACCEPT",
  "decision_at": "2025-09-25T16:48:11.028038014Z",
  "status": "CLOSED",
  "sub_status": "Accept",
  "tags": null,
  "notes": "",
  "review_queues": [
    "Default Queue"
  ],
  "data_enrichments": [
    {
      "enrichment_name": "Socure Document Request - Default Flow",
      "enrichment_endpoint": "https://service.socure.com/api/5.0/documents/request",
      "enrichment_provider": "SocureDocRequest",
      "status_code": 200,
      "request": {
        "city": "Springfield",
        "config": {
          "sendMessage": true
        },
        "country": "US",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "physicalAddress": "742 Evergreen Terrace",
        "state": "IL",
        "surName": "Valley",
        "zip": "62704"
      },
      "response": {
        "__third_party_name__": "Socure Document Request - Default Flow",
        "data": {
          "docvTransactionToken": "6a95fcbd-4f42-4673-890f-ca90cd54f7f0",
          "eventId": "6a95fcbd-4f42-4673-890f-ca90cd54f7f0",
          "qrCode": "data:image/png;base64,...",
          "url": "https://verify.socure.com/#/dv/6a95fcbd-4f42-4673-890f-ca90cd54f7f0"
        },
        "deviceSessionToken": "eyJraWQiOiJmMzRiN2YiLCJhbGciOiJIUzUxMiIsInR5cCI6Ik...",
        "status": "SESSION_COMPLETE"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Document Verification - Default Flow",
      "enrichment_endpoint": "https://sandbox.socure.com/api/3.0/EmailAuthScore",
      "enrichment_provider": "Socure",
      "status_code": 200,
      "request": {
        "authorityVerificationConfig": {},
        "city": "Springfield",
        "country": "US",
        "deviceSessionId": "eyJraWQiOi_di_token",
        "docvTransactionToken": "6a95fcbd-4f42-4673-890f-ca90cd54f7f0",
        "email": "[email protected]",
        "firstName": "Franky",
        "mobileNumber": "16673681976",
        "modules": ["documentverification"],
        "parentTxnId": "1e85e088-ade0-4ef6-bb6d-3524da429114",
        "physicalAddress": "742 Evergreen Terrace",
        "riskOSId": "a86580cc-1733-4188-86b5-717166e1db8c",
        "state": "IL",
        "surName": "Valley",
        "userId": "username",
        "workflow": "consumer_onboarding",
        "zip": "62704"
      },
      "response": {
        "customerProfile": {
          "userId": "username"
        },
        "documentVerification": {
          "decision": {
            "name": "standard",
            "value": "accept"
          },
          "digitalIntelligence": {
            "behavioral": {
              "aggregations": {
                "blurCount": 10,
                "clickCount": 1,
                "focusCount": 1,
                "inputChangeCount": 1,
                "pasteCount": 1,
                "submissionCount": 1,
                "totalEventCount": 10
              },
              "duration": 5050,
              "serverCreated": "2025-01-14T00:10:50.942Z",
              "serverUpdated": "2025-01-14T00:10:51.692Z",
              "sessionId": "a1cf60e7-5915-4734-9130-223c8371f12a",
              "source": "http://localhost:3000/"
            },
            "device": {
              "attributes": {
                "androidAttributes": {},
                "battery": {
                  "batteryLevel": 0.88,
                  "batteryState": "charging"
                },
                "deviceManufacturer": "Apple",
                "deviceMemory": 8,
                "deviceModel": "Apple Macintosh",
                "devicePixelRatio": 1.1,
                "deviceType": "Desktop",
                "iOSAttributes": {},
                "language": "en-US",
                "location": {},
                "os": "Mac OS",
                "osVersion": "14.5.0",
                "platform": "Web",
                "screenHeight": 1080,
                "screenWidth": 1920,
                "sdkVersion": "2.5.0",
                "timeZone": "America/Los_Angeles",
                "timeZoneOffset": -480,
                "viewportHeight": 668,
                "viewportWidth": 598,
                "webAttributes": {
                  "browser": "Chrome",
                  "browserVersion": "131.0.6778.205",
                  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
                  "userAgentExtractionRequired": true
                }
              },
              "computed": {
                "isVirtualMachine": false,
                "sessionAgeMinutes": 45,
                "statisticalId": "e81a14d6621cfd2ed9390be9d9eba266851e391aa751881cda9f74377197980b"
              },
              "deviceCaptureAt": "2025-01-14T00:10:49.385195428Z",
              "history": {
                "daysSeen": ["2025-01-08", "2025-01-14"],
                "firstSeen": "2025-01-08T15:55:46.143356159Z",
                "ips": ["192.184.177.36", "72.150.12.157"],
                "isps": ["sonic.net llc", "comcast cable communications inc."],
                "lastSeen": "2025-01-14T00:10:49.385195428Z",
                "networkLocations": ["houston, ca", "redwood city, ca"]
              },
              "id": "844da0ea-767a-48da-8cb5-5f2e179f43f4",
              "network": {
                "asn": 7922,
                "asnName": "comcast cable communications llc",
                "connectionIp": "72.150.12.157",
                "domainName": "comcast.net",
                "isConsumerPrivacy": false,
                "isMobileCarrier": false,
                "isProxy": false,
                "isRiskyNetwork": false,
                "isTor": false,
                "isVpn": false,
                "isp": "comcast cable communications inc.",
                "ispType": "home",
                "networkLocation": {
                  "city": "redwood city",
                  "continentCode": "NA",
                  "countryCode": "us",
                  "gmtOffset": "-800",
                  "latitude": 37.38,
                  "longitude": -122.23,
                  "metroCode": 807,
                  "postalCode": "94062",
                  "region": "ca",
                  "timezoneName": "america/los_angeles"
                },
                "org": "comcast cable communications inc.",
                "realIp": "72.150.12.157",
                "speed": "cable",
                "webRtcInternalIp": "72.150.12.157",
                "webRtcPublicIp": "72.150.12.157"
              },
              "sessionCreatedAt": "2025-01-14T00:10:49.377717442Z"
            },
            "entityProfiler": [],
            "latestNavigationContexts": [],
            "velocityMetrics": {
              "historicalCount": {
                "email": { "uniqueCount": 1, "uniqueSharePercent": 100 },
                "firstName": { "uniqueCount": 0, "uniqueSharePercent": 0 },
                "mobileNumber": { "uniqueCount": 1, "uniqueSharePercent": 100 },
                "surName": { "uniqueCount": 0, "uniqueSharePercent": 0 }
              }
            }
          },
          "documentData": {
            "address": "742 Evergreen Terrace, Springfield, IL 62704",
            "dob": "1992-03-11",
            "documentNumber": "11223344",
            "expirationDate": "2030-01-01",
            "firstName": "Franky",
            "fullName": "Franky Valley",
            "issueDate": "2015-01-01",
            "parsedAddress": {
              "city": "Springfield",
              "country": "US",
              "physicalAddress": "742 Evergreen Terrace",
              "state": "IL",
              "zip": "62704"
            },
            "surName": "Valley"
          },
          "documentType": {
            "country": "USA",
            "state": "NY",
            "type": "Drivers License"
          },
          "reasonCodes": ["I831", "I836"]
        },
        "referenceId": "85dab430-0cbd-4286-a745-f03be14e33e2"
      },
      "is_source_cache": false,
      "total_attempts": 1
    },
    {
      "enrichment_name": "Socure Image Request - Default Flow",
      "enrichment_endpoint": "https://upload.socure.com/api/5.0/documents/{referenceId}",
      "enrichment_provider": "SocureImageRequest",
      "error_message": "zip: not a valid zip file",
      "request": {
        "referenceId": "85dab430-0cbd-4286-a745-f03be14e33e2"
      },
      "is_source_cache": false,
      "total_attempts": 1
    }
  ],
  "eval_status": "evaluation_completed",
  "environment_name": "Sandbox"
}

Interpreting key results

The Predictive DocV enrichment includes reason codes, extracted data, and the final DocV decision. The most important fields are:

DocV decision:

  • data_enrichments.response.documentVerification.decision.value → DocV result (accept, review, resubmit, reject)
  • data_enrichments.response.documentVerification.reasonCodes → explanations/flags
  • data_enrichments.response.documentVerification.documentData → extracted fields (e.g., DOB, document number)
  • Top‑level decision + routing metadata → use for your workflow handling and for the overall workflow decision

Best practices for integration and maintenance

  • Validate inputs against schema.
  • Use sandbox identities during QA.
  • Monitor reasonCodes, tags, and review_queues for routing and audit.
  • Redact secrets from logs and include correlation IDs.

Validation checklist

Test coverage

Valid candidates → ACCEPT
Fraudulent candidates → REJECT or REVIEW
Edge cases logged + reviewed

Schema and error handling

Fields match schema across environments
Errors are structured and retryable
Use exponential fallback with jitter for retries

Logging and observability

Log full request/response
Include correlation IDs
Redact sensitive data from logs

Updated 6 days ago