Dry Run

Uses an SSN and/or Email Address to evaluate whether or not a lead has been previously purchased or that any money has been spent on underwriting. Responses return a single "pass" field which contains a pass/fail result of the evaluation. The result is a boolean value of either "true" (passes evaluation) or "false" (fails evaluation). Optionally use the lookback window fields to adjust the amount of time each evaluation should look back for any matching records. To disable either of the evaluations set the lookback value to "false".

Authorization OAuth 2.0

This request requires OAuth 2.0 authorization.

Header Parameters

• Authorization string required

  Bearer {ACCESS_TOKEN}

• Content-Type string required

  application/json

• Accept string required

  application/json

Request Parameters

• social_security_number string required without

  The lead 9 digit social security number with no delimiters.

  DANGER

  Required without email

• email string required without

  The lead email address.

  DANGER

  Required without social_security_number

• previously_purchased_lookback_window integer boolean

  Lookback window, in days, for previously purchased leads. Defaults to an all-time lookback window. Set to "false" to disable.

• underwriting_cost_lookback_window integer boolean

  Lookback window, in days, for leads with money spent on underwriting. Defaults to a 3 day lookback window. Set to "false" to disable.

Response Parameters

• data object

  • pass boolean

    The result of the evaluation.

  • reason string

    The reason the evaluation failed. Either the ID of the account that previously purchased the lead or the string "UW" if any money was spent on underwriting.

POST /api/v1/lead-processing/dry-run

cURL

curl --request POST \
    "https://api.decisioncloud.me/api/v1/lead-processing/dry-run" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"social_security_number\": \"886691409\",
    \"email\": \"john.doe@gmail.com\",
    \"previously_purchased_lookback_window\": 30,
    \"underwriting_cost_lookback_window\": 3
}"

JavaScript

const url = new URL(
    "https://api.decisioncloud.me/api/v1/lead-processing/dry-run"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "social_security_number": "886691409",
    "email": "john.doe@gmail.com",
    "previously_purchased_lookback_window": 30,
    "underwriting_cost_lookback_window": 3
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

PHP

$client = new \GuzzleHttp\Client();
$response = $client->post(
    'https://api.decisioncloud.me/api/v1/lead-processing/dry-run',
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'social_security_number' => '886691409',
            'email' => 'john.doe@gmail.com',
            'previously_purchased_lookback_window' => 30,
            'underwriting_cost_lookback_window' => 3,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Python

import requests
import json

url = 'https://api.decisioncloud.me/api/v1/lead-processing/dry-run'
payload = {
    "social_security_number": "886691409",
    "email": "john.doe@gmail.com",
    "previously_purchased_lookback_window": 30,
    "underwriting_cost_lookback_window": 3
}
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

200 Pass

{
    "data": {
        "pass": true
    }
}

200 Fail

{
    "data": {
        "pass": false,
        "reason": "UW"
    }
}