Skip to main content
POST
https://api.dintero.com/v1
/
accounts
/
{aid}
/
compliance-search
/
vmss
accounts_aid_search_vmss_post
curl --request POST \
  --url https://api.dintero.com/v1/accounts/{aid}/compliance-search/vmss \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchant": {
    "address": {
      "city": "St Albans",
      "countryOrRegion": "NO",
      "streetAddress": "80 Wood Street",
      "stateOrProvince": "CA",
      "zipOrPostalCode": "SA82GF"
    },
    "DBAName": "Snap Photoshop Ltd",
    "principals": [
      {
        "name": "Bill Smith",
        "SSN": "<string>",
        "principalID": "07043453",
        "passportNumber": "07043453",
        "businessPhoneNumber": "+861071111222",
        "driverLicenseNumber": "07043453",
        "businessEmailAddress": "billsmith@snapphoto.com",
        "residentIDOrNationalID": "07043453"
      }
    ],
    "businessPhoneNumbers": [
      "+861071111222"
    ],
    "taxID": "GB123456789",
    "category": "1",
    "legalName": "Snap Photoshop Ltd",
    "webAddresses": [
      "https://u.nu"
    ],
    "financialAccts": [
      {
        "intBankAccountNumber": "NO8330001234567",
        "financialAccountNumber": "8090765400",
        "financialInstitutionID": "101010"
      }
    ],
    "tradeOverInternet": false,
    "businessEmailAddress": "billsmith@snapphoto.com",
    "merchantCategoryCodes": [
      "5411"
    ],
    "businessRegistrationNumber": "452349600005"
  }
}
'
{
  "searchTerminatedResponse": {
    "possibleMatches": {
      "matchedRecords": [
        {
          "acquirerBID": "10048640",
          "acquirerName": "Bank of ABC",
          "terminatedRefID": "61e8aa42-d252-4e74-9dcc-85134f37a181",
          "terminatedRecord": {
            "DBAName": "Snap Photoshop Ltd",
            "address": {
              "city": "St Albans",
              "countryOrRegion": "NO",
              "streetAddress": "80 Wood Street",
              "stateOrProvince": "CA",
              "zipOrPostalCode": "SA82GF"
            },
            "category": "1",
            "principals": [
              {
                "name": "Bill Smith",
                "SSN": "<string>",
                "principalID": "07043453",
                "passportNumber": "07043453",
                "businessPhoneNumber": "+861071111222",
                "driverLicenseNumber": "07043453",
                "businessEmailAddress": "billsmith@snapphoto.com",
                "residentIDOrNationalID": "07043453"
              }
            ],
            "cardAcceptorIDs": [
              "12345678910111"
            ],
            "contractEndDate": "2019-11-14",
            "contractStartDate": "2019-11-01",
            "tradeOverInternet": false,
            "businessPhoneNumbers": [
              "+861071111222"
            ],
            "incorportationStatus": "3",
            "primaryListingReason": "29-Bankruptcy/Liquidation/Insolvency",
            "tradeInternationally": true,
            "merchantCategoryCodes": [
              "5411"
            ],
            "taxID": "GB123456789",
            "legalName": "Snap Photoshop Ltd",
            "webAddresses": [
              "https://u.nu"
            ],
            "financialAccts": [
              {
                "intBankAccountNumber": "NO8330001234567",
                "financialAccountNumber": "8090765400",
                "financialInstitutionID": "101010"
              }
            ],
            "businessEmailAddress": "billsmith@snapphoto.com",
            "paymentFacilitatorBID": "10000108",
            "secondaryListingReason": "34-Merchant Identity Theft",
            "acquirerAssignedMerchantID": "36654773",
            "businessRegistrationNumber": "452349600005",
            "paymentFacilitatorCountryOrRegion": "NO"
          },
          "terminatedRecordMatch": {
            "taxID": "N",
            "DBAName": "N",
            "legalName": "N",
            "addressMatch": {
              "city": "N",
              "streetAddress": "N",
              "countryOrRegion": "N",
              "stateOrProvince": "N",
              "zipOrPostalCode": "N"
            },
            "webAddresses": "N",
            "principalsMatch": [
              {
                "SSN": "N",
                "name": "N",
                "principalID": "N",
                "passportNumber": "N",
                "businessPhoneNumber": "N",
                "driverLicenseNumber": "N",
                "businessEmailAddress": "N",
                "residentIDOrNationalID": "N"
              }
            ],
            "tradeOverInternet": "N",
            "financialAcctsMatch": [
              {
                "intBankAccountNumber": "N",
                "financialAccountNumber": "N",
                "financialInstitutionID": "N"
              }
            ],
            "businessEmailAddress": "N",
            "businessPhoneNumbers": "N",
            "merchantCategoryCodes": "N",
            "businessRegistrationNumber": "N"
          },
          "acquirerCountryOrRegion": "NO"
        }
      ],
      "totalCount": 123
    },
    "searchRequestRef": {
      "acquirerBID": "10048640",
      "globalSearch": false,
      "searchRequestRefID": "SRCH123412",
      "acquirerCountryOrRegion": "NO",
      "terminatedRecordSearchCriteria": {
        "address": {
          "city": "St Albans",
          "countryOrRegion": "NO",
          "streetAddress": "80 Wood Street",
          "stateOrProvince": "CA",
          "zipOrPostalCode": "SA82GF"
        },
        "DBAName": "Snap Photoshop Ltd",
        "principals": [
          {
            "name": "Bill Smith",
            "SSN": "<string>",
            "principalID": "07043453",
            "passportNumber": "07043453",
            "businessPhoneNumber": "+861071111222",
            "driverLicenseNumber": "07043453",
            "businessEmailAddress": "billsmith@snapphoto.com",
            "residentIDOrNationalID": "07043453"
          }
        ],
        "businessPhoneNumbers": [
          "+861071111222"
        ],
        "taxID": "GB123456789",
        "category": "1",
        "legalName": "Snap Photoshop Ltd",
        "webAddresses": [
          "https://u.nu"
        ],
        "financialAccts": [
          {
            "intBankAccountNumber": "NO8330001234567",
            "financialAccountNumber": "8090765400",
            "financialInstitutionID": "101010"
          }
        ],
        "tradeOverInternet": false,
        "businessEmailAddress": "billsmith@snapphoto.com",
        "merchantCategoryCodes": [
          "5411"
        ],
        "businessRegistrationNumber": "452349600005"
      }
    }
  },
  "status": {
    "statusDescription": "Success",
    "statusCode": "API000"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.dintero.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication (token authentication) should be used for accessing the API.

Use Get Token to get an access token for client credentials. Pass the token in the request header:

Authorization: Bearer {access_token}

where the access_token is JSON Web Tokens (JWT).

Path Parameters

​
aid
string<^[PT]{1}\d{8}$>
required

An id that uniquely identifies the account.

Required string length: 9

Body

application/json
​
merchant
object
required

Response

Possible merchant matches from VMSS

​
searchTerminatedResponse
object
​
status
object
Last modified on May 29, 2026