/api/v1/merchant/getAutoUwResults

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Get Auto UW Results

Returns the results of automated underwriting (autoUW) verification checks that the system has run against a merchant. Each result identifies a verification type and its outcome. Optionally, results can be filtered to return only checks that failed, making it easy to identify which areas require attention before manual review.

Endpoint

GET /api/v1/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 has been submitted to TSYS and the system has performed its automated pre-screening. The autoUW checks run automatically and cover areas such as MATCH list verification, OFAC screening, GIACT bank validation, Google search, WHOIS, and Clear background checks. Call this endpoint to review automated findings before escalating to a human underwriter, or to display compliance check results in an ISO dashboard.

Query Parameters

ParameterTypeRequiredDescription
idinteger (int32)YesMerchant profile ID to retrieve autoUW results for
failedChecksbooleanNoWhen true, returns only failed checks. When false or omitted, returns all check results

Response

200 OK

FieldTypeDescription
dataarrayList of automated verification results
data[].verificationTypestringName of the automated check (e.g., "AutomatedMATCH", "AutomatedOfac")
data[].verificationResultstringOutcome of the check (e.g., "Pass", "Fail", "Review")
requestIdintegerUnique identifier for this API request
successbooleantrue if the request completed successfully
errorstringError message if the request failed
validationErrorsarrayField-level validation errors
{
  "data": [
    {
      "verificationType": "AutomatedMATCH",
      "verificationResult": "Pass"
    },
    {
      "verificationType": "AutomatedOfac",
      "verificationResult": "Pass"
    },
    {
      "verificationType": "AutomatedGiact",
      "verificationResult": "Fail"
    },
    {
      "verificationType": "AutomatedGoogleSearch",
      "verificationResult": "Review"
    },
    {
      "verificationType": "AutomatedWhois",
      "verificationResult": "Pass"
    },
    {
      "verificationType": "AutomatedClear",
      "verificationResult": "Pass"
    }
  ],
  "requestId": 88621,
  "success": true,
  "error": null,
  "validationErrors": []
}

Error Codes

CodeWhen it happens
400id is missing or not a valid integer
401Invalid or missing Basic Auth credentials
403User does not have permission for this operation
404Merchant not found
500Internal server error

Common Mistakes

  • Calling this endpoint before the merchant has been submitted — autoUW checks only run after submission, so results may be empty or unavailable for draft merchants.
  • Misinterpreting a "Review" result as a failure — a "Review" result means the check flagged something that requires human inspection, not that the merchant is rejected.
  • Forgetting the failedChecks=true filter when you only want to surface actionable problems in a UI.

Related Endpoints

  • GET /api/v1/underwriting/statuses — get the current underwriting status for all merchants
  • GET /api/v1/underwriting/status-history — get the full underwriting status history for a merchant
  • POST /api/v1/underwriting/pending-review — notify the UW team after corrections have been made

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/merchant/getAutoUwResults?id=48201&failedChecks=true" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)"
Query Params
int32
required
boolean
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json