Get Auto Underwriting Results V2

Retrieves the full list of automated underwriting check results for a merchant. Each result shows what was expected, what was actually found, the verification type, and the final outcome. Supports filtering to return only failed checks, making it easy to focus on issues that require attention.

Endpoint

GET /api/v2/merchant/getAutoUwResults

Authentication

Basic HTTP Authentication required. Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Use this endpoint after a merchant application has been submitted and auto-underwriting has run. It gives underwriters a consolidated view of all automated rule checks — what the system expected vs. what it found — so they can quickly identify compliance issues, risk flags, or data mismatches. Pass failedChecks=true to get a focused list of only the checks that did not pass, useful for building rejection summaries or underwriter review queues.

Query Parameters

Response

200 OK

All checks (failedChecks=false):

{
  "data": [
    {
      "verificationType": "OFAC",
      "expectedResult": "No matches",
      "actualResult": "No matches found",
      "verificationResult": "Pass"
    },
    {
      "verificationType": "TINCheck",
      "expectedResult": "Match",
      "actualResult": "Match",
      "verificationResult": "Pass"
    },
    {
      "verificationType": "CreditScore",
      "expectedResult": ">= 600",
      "actualResult": "720",
      "verificationResult": "Pass"
    },
    {
      "verificationType": "Bankruptcy",
      "expectedResult": "No active bankruptcy",
      "actualResult": "No records found",
      "verificationResult": "Pass"
    },
    {
      "verificationType": "MasterCardTermination",
      "expectedResult": "Not on MATCH list",
      "actualResult": "Found 1 record",
      "verificationResult": "Fail"
    }
  ],
  "requestId": 4189012,
  "success": true,
  "error": null
}

Failed checks only (failedChecks=true):

{
  "data": [
    {
      "verificationType": "MasterCardTermination",
      "expectedResult": "Not on MATCH list",
      "actualResult": "Found 1 record",
      "verificationResult": "Fail"
    }
  ],
  "requestId": 4189013,
  "success": true,
  "error": null
}

Error Codes

Common Mistakes

• Calling this before auto-underwriting has run — if no checks have been executed yet, the data array will be empty. Ensure the merchant application has been submitted first.
• Ignoring Review results — verificationResult: "Review" means the check could not be automatically resolved and requires manual underwriter action.
• Using v1 endpoint — the previous version GET /api/v1/merchant/getAutoUwResults exists but use this v2 endpoint which returns the extended AutoUwResultV2 schema with expectedResult and actualResult fields.

Related Endpoints

• GET /api/v1/merchant/bladeReview — broader Blade verification results across 12 sources
• GET /api/v1/merchant/creditProfile — Experian credit profile checks
• POST /api/v1/merchant/creditProfile/softPull — trigger Experian soft pull

Example

# Get all results
curl -X GET "https://hq.staging.netevia.dev/api/v2/merchant/getAutoUwResults?id=161787" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)"

# Get only failed checks
curl -X GET "https://hq.staging.netevia.dev/api/v2/merchant/getAutoUwResults?id=161787&failedChecks=true" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)"