Overview

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. If you’re interested in a REST version of the API, please reach out to sales@TINCheck.com.

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's 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.

⚠️ IMPORTANT: New API path

If you’re currently using https://www.tincheck.com/pvsws/pvsservice.asmx as the TINCheck API path, please update your system to point to the https://api.tincheck.com/pvsws/pvsservice.asmx path to avoid any potential disruptions. Learn more this API update ›

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’s 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

How to test the TINCheck SOAP API

We suggest using Postman or a similar service.