Verify

Verify

This endpoint allows you to verify an individual or business through multiple trusted data sources such as OFAC, USPS, NCOA, GIIN, and DMF. By submitting identity and address information along with the required verification types, the API returns detailed verification results including status, messages, and match information from each selected verification service.

For example, GIIN validation confirms FATCA registration for businesses, DMF validation checks whether an individual is listed as deceased, OFAC screening identifies matches against U.S. sanctions lists, and USPS/NCOA validate and update address information. These verification responses help ensure the legitimacy, compliance, and accuracy of business and individual records.

POST v2/Verification/Verify 

Request Body

Field	Type	Description
Verifications	String[]	List of verification services to be performed. Allowed values "OFAC", "USPS", "GIIN", "DMF"
OFACMatchConfig	Object	Configuration details for OFAC matching criteria.
MinScore	Number	Minimum match score required for an OFAC match to be considered.
TopMatches	Number	Maximum number of OFAC matches to return in the response.
Identity	Object	Identity details of the individual or business being verified.
BusinessNm	String	Legal name of the business. Size Range: ..75
TradeNm	String	Optional Trade or DBA (Doing Business As) name of the business. Size Range: ..75
GIIN	String	Global Intermediary Identification Number (GIIN) of the business. Size Range: 19
FirstNm	String	First name of the individual. Size Range: ..20
MiddleNm	String	Optional Middle name of the individual. Size Range: ..20
LastNm	String	Last name of the individual. Size Range: ..20
TINType	String	Taxpayer Identification Number type of the individual. Allowed values "SSN", "EIN"
TIN	String	Taxpayer Identification Number of the individual or business. Size Range: 9-11
Address	Object	Address details of the individual or business.
Address1	String	Address line 1 (street address or post office box). Size Range: ..46
Address2	String	Address line 2 (suite or apartment). Size Range: ..46
City	String	City name. Size Range: ..50
ProvinceOrState	String	State or province code. Size Range: 2
ZipCode	String	Postal or ZIP code. Size Range: 5..10
Country	String	Two-character ISO country code. Size Range: 2

Response Body

Field	Type	Description
SubmissionId	String	Unique identifier generated for the verification request.
BusinessNm	String	Legal business name.
TradeNm	String	Trade or DBA name of the business.
FirstNm	String	First name of the individual.
MiddleNm	String	Middle name of the individual.
LastNm	String	Last name of the individual.
VerificationDetails	Object	Verification results returned for each requested verification service.
DMF	Object	Death Master File verification details.
Status	String	Indicates whether the individual is found in the Death Master File.
Message	String	Detailed DMF verification message.
OFAC	Object	OFAC sanctions screening details.
Status	String	Indicates whether the individual or business was found on OFAC sanctions lists.
Message	String	Detailed OFAC verification message.
MatchCount	Number	Total number of OFAC matches found.
HighestConfidence	String	Highest confidence level among the returned OFAC matches.
HighestScore	Number	Highest OFAC match score returned.
MatchDetails	Object[]	Detailed information for each OFAC match.
MatchId	String	Unique identifier of the OFAC match record.
Name	String	Name matched from the OFAC sanctions database.
Type	String	Entity type of the match (Individual, Organization, Vessel, etc.).
ListType	String	OFAC sanctions list type (for example, SDN).
Programs	String[]	List of sanctions programs associated with the matched entity.
Country	String	Country associated with the matched entity.
Score	Number	Match score returned by OFAC screening.
Confidence	String	Confidence level of the OFAC match.
USPS	Object	USPS address verification details.
Status	String	Indicates whether the supplied address is valid according to USPS.
Message	String	Detailed USPS verification message.
OriginalAddress	Object	Original address submitted in the verification request.
Address1	String	Address line 1.
Address2	String	Address line 2.
City	String	City name.
State	String	State code.
ZipCd	String	ZIP code.
Country	String	Country code.
UpdatedAddress	Object	USPS-recommended standardized address, if applicable. Returns null when no changes are suggested.
NCOA	Object	National Change of Address verification details. Returns null if NCOA verification was not requested or no forwarding address exists.
GIIN	Object	GIIN verification details.
Status	String	Indicates whether the submitted GIIN is valid and registered under FATCA.
Message	String	Detailed GIIN verification message.
GIIN	String	Verified Global Intermediary Identification Number.
Country	String	Country in which the GIIN is registered.
GIINCountryCode	String	Country code of the GIIN registration country.
GIINBusinessNm	String	Business name registered with the submitted GIIN.
Errors	Object[]	List of errors encountered during verification processing. Returns null if no errors occurred.

Request JSON

{
    "Verifications": [
        "OFAC",
        "USPS",
        "GIIN",
        "DMF"
    ],
    "OFACMatchConfig": {
        "MinScore": 70,
        "TopMatches": 10
    },
    "Identity": {
        "BusinessNm": "SnowDaze LLC",
        "TradeNm": "Iceberg Icecreams",
        "GIIN": "2T2ABC.99991.SL.123",
        "FirstNm": "Shawn",
        "MiddleNm": "Joe",
        "LastNm": "Williams",
        "TINType": "SSN",
        "TIN": "123450000"
    },
    "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 100",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCode": "29730",
        "Country": "US"
    }
}

Response JSON

200

{
  "SubmissionId": "154c793c-0104-462e-b8a9-5f88ca93ccfd",
  "BusinessNm": "",
  "TradeNm": "Iceberg Icecreams",
  "FirstNm": "Shawn",
  "MiddleNm": "Joe",
  "LastNm": "Williams",
  "VerificationDetails": {
      "DMF": {
          "Status": "MATCH",
          "Message": "Match found in the Death Master File."
      },
      "OFAC": {
          "Status": "LIST_FOUND",
          "Message": "Name found in the OFAC sanctions list",
          "MatchCount": 1,
          "HighestConfidence": "Strong",
          "HighestScore": 100,
          "MatchDetails": [
              {
                  "MatchId": "12345",
                  "Name": "SHAWN WILLIAMS",
                  "Type": "individual",
                  "ListType": "SDN",
                  "Programs": [
                      "SDGT"
                  ],
                  "Country": "",
                  "Score": 100,
                  "Confidence": "Strong"
              }
          ]
      },
      "USPS": {
          "Status": "VALID",
          "Message": "Address is valid",
          "OriginalAddress": {
              "Address1": "123 Main St",
              "Address2": "Suite 100",
              "City": "Rock Hill",
              "State": "SC",
              "ZipCd": "29730",
              "Country": "US"
          },
          "UpdatedAddress": null
      },
      "NCOA": null,
      "GIIN": {
          "Status": "MATCH",
          "Message": "GIIN found and registered under FATCA.",
          "GIIN": "2T2ABC.99991.SL.123",
          "Country": "CHINA",
          "GIINCountryCode": "CH",
          "GIINBusinessNm": "SnowDaze LLC"
      }
  },
  "Errors": null
}

400

{
  "SubmissionId": null,
  "BusinessNm": "",
  "TradeNm": null,
  "FirstNm": null,
  "MiddleNm": null,
  "LastNm": null,
  "VerificationDetails": null,
  "Errors": [
      {
          "Id": "V00-100005",
          "Name": "Identity.Tin",
          "Message": "Invalid Tin"
      }
  ]
}