About the TINCheck SOAP API

Learn about TINCheck's SOAP API.

The TINCheck API allows you to bring the TINCheck validation service directly to your backend systems. This approach means validation results can be retrieved programmatically, and integrated directly into any system.

Note:

The current (v1) version of the API is SOAP-based. Click here to learn more about the REST version of the API.

Tip:

Looking for a bulk import option? TINCheck offers a separate bulk upload option which is not part of the API. Learn more about Bulk options and pricing.

Enabling the TINCheck SOAP API

If you have an active pre-paid or monthly plan, you have access to the TINCheck API. There is no additional sign-up or activation process needed. Each check performed through the API will count against your monthly or pre-paid allotment of checks.

Accessing the TINCheck API

The TINCheck web service is located at the following URL path: https://api.tincheck.com/pvsws/pvsservice.asmx.

The Web Service Definition (WSDL) for the TINCheck SOAP API is available at https://api.tincheck.com/pvsws/pvsservice.asmx?wsdl and is the best way to understand the full capabilities of the API and the methods it supports.

Authenticating each request

The TINCheck SOAP API uses simple authentication which allows any user with API access enabled on their account to pass their username and password along with their request as a means of authentication. Pass your TINCheck email address as the UserLogin parameter and your password as the UserPassword parameter.

Note:

The UserID and UserEncryption parameters are not used and should be left empty.

Available Web Service Methods

The TINCheck SOAP API provides four methods for returning results, each with different requirements for what is sent in the request.

ValidateTinName

Runs basic TIN/Name validation.
Learn more about validating a TIN/Name using the SOAP API.

ServiceStatus

Returns system status and the number of checks remaining for the authenticated API user.
Learn more about checking Service Status using the SOAP API.

ValidateListMatch

Runs list validations (including OFAC and casino barred lists).
Learn more about validating list matches using the SOAP API.

ValidateTinNameAddressListMatch

Runs all TINCheck validations at once including IRS TIN/Name, USPS address, DMF, OFAC and casino barred lists.
Learn more about running all validations at once using the SOAP API.

Testing the TINCheck SOAP API

We suggest using Postman or a similar service.

Sovos Docs