Overview

TINCheck offers an integrated web service that allows developers to call all validations programmatically. This enables you to build-in any of TINCheck's validation directly into your existing applications or web pages.

TINPlus (Bulk files)

For bulk file upload specifications and details visit here. For real-time validation continue reading below.

Example Uses

  • Add validations to your online account opening process.
  • Add validations to your AP vendor screens.
  • Add validations to your vendor database backend.
  • Add validations anywhere in your existing processes.

Web Service URL

The TINCheck web service is located at https://www.tincheck.com/pvsws/pvsservice.asmx?wsdl

Web Service Login & Password

Any TINCheck user login and password is valid for use with the web service. That means any interactive user that can login to the website and run checks can be used with the web service. This even includes trial accounts. Just pass your TINCheck login 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.

4 Web Service Methods

Items highlighted in green can be considered a positive good result. Items highlighted in red can be considered a positive bad result. Anything else can be considered a failure.

  • Version, Version(HttpGet), Version(HttpPost), BulkTinCheckObject, BulkTinCheck, BulkTinCheckStatus, and BulkTinCheckResult: Internal use only.

  • Service Status (Click to Expand) : This method returns the system status and the number of checks left for the user.

    Input
    [CurUser]
    <UserID>: empty
    <UserLogin>: TINCheck Login
    <UserPassword>: TINCheck Password
    <UserEncryption>: empty

    Output
    [ServiceStatusResponse]
    <Status>: See table
    <CallsRemaining>: See table

    StatusDetails
    OKSystem is functioning normally
    CallsRemainingDetails
    No LimitMonthly Plan
    NumberChecks Remaining

  • ValidateListMatch (Click to Expand) : This method runs the list validations. The OFAC and casino barred lists.

    Input
    [TinName]
    <TIN>(Optional): The subjects 9 digit TIN (EIN or SSN), unformatted.
    <FName>(Optional): The subjects first name if parsed.
    <LName>: The subjects last name if parsed or the subjects full name (First Last) or the full Company name.
    <GIIN>(Optional): The subjects FATCA\FFI GIIN.
    <Encryption>: empty
    [CurUser]
    <UserID>: empty
    <UserLogin>: TINCheck Login
    <UserPassword>: TINCheck Password
    <UserEncryption>: empty

    Output
    [ValidateListMatchResult]
    <LISTSMATCH_CODE>: See table
    <LISTSMATCH_DETAILS>: See table
    [XXXX_RESULT] (Legacy): OFAC_RESULT, NV_RESULT, MS_RESULT, IL_RESULT, MO_RESULT, NJ_RESULT, EPLS_RESULT, DPL_RESULT, PEP_RESULT, and HHS_RESULT.
    <XXXX_CODE>: See table
    <XXXX_DETAILS>: See table
    <XXXX_COUNT>: See table
    <XXXX_DATA>: See table
    [Results] (New): A list of Result.
    ->[Result] A Result.
    -><Type>: OFAC, PEP, PLC, IL, ISA, MO, MS, NJ, NV, SSI, UKE, UVL, DFTO, DPL, DTC, EAR, EPLS, EUS, FBIAVC, FBICA, FBICAC, FBICC, FBICEI, FBIDT, FBIMWT, FBISI, FBISTI, FBITMW, FBIVCM, FBIWCC, FFI, FSE, GIIN, HHS, and IEO.
    -><Code>: See table
    -><Details>: See table
    -><Count>: See table
    -><Data>: See table
    [STATUS] Web service status
    <Status>: See table
    <CallsRemaining>: See table

    LISTSMATCH_CODELISTSMATCH_DETAILS
    -1Lists Match Not Processed
    0No Lists Matches Found
    1Possible Lists Matches Found
    10Login denied: Invalid User Login and/or Password
    11Problem processing List Match Vaidation request: Invalid Data. {Details}
    12Invalid Configuration: No Lists enabled
    13Invalid Lists Matching request
    15Connection problem
    16Lists Connection Problem
    17Lists Match temporarily unavailable
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account
    20Processing Error
    21Lists Match Processing Error
    23Login denied: Invalid User
    24Login denied: Invalid Password
    25Login denied: This Account has been locked
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts
    27Login denied: Terms not accepted
    28Login denied: Account Expired
    29Login denied: No Security rights
    XXXX_CODEXXXX_DETAILSXXXX_COUNTXML Decode(XXXX_DATA)
    0No Lists Matches Found0 
    1XXXX List: Possible X Matches Found.XDetails
    TypeCodeDetailsCountXML Decode(Data)
    XXXX0No Lists Matches Found0 
    XXXX1XXXX List: Possible X Matches Found.XDetails
    StatusDetails
    OKSystem is functioning normally
    CallsRemainingDetails
    No LimitMonthly Plan
    NumberChecks Remaining

  • ValidateTinName (Click to Expand) : This method runs the IRS TIN/Name validation.

    Input
    [TinName]
    <TIN>: The subjects 9 digit TIN (EIN or SSN), unformatted.
    <LName>: The subjects last name if parsed or the subjects full name (First Last) or the full Company name.
    <FName>(Optional): The subjects first name if parsed.
    <GIIN>(Optional): The subjects FATCA\FFI GIIN.
    <Encryption>: empty
    [CurUser]
    <UserID>: empty
    <UserLogin>: TINCheck Login
    <UserPassword>: TINCheck Password
    <UserEncryption>: empty

    Output
    [ValidateTinNameResult]
    <TINNAME_CODE>: See table
    <TINNAME_DETAILS>: See table
    <DMF_CODE>: See table
    <DMF_DETAILS>: See table
    <DMF_DATA>: See table
    <EIN_CODE>: See table
    <EIN_DETAILS>: See table
    <EIN_DATA>: See table

    [STATUS] Web service status
    <Status>: See table
    <CallsRemaining>: See table

    TINNAME_CODETINNAME_DETAILS
    -1Tin/Name Validation Not Processed
    0TIN and Name combination does not match IRS records
    1TIN and Name combination matches IRS records
    5TIN entered is not currently issued
    6TIN and Name combination matches IRS SSN records
    7TIN and Name combination matches IRS EIN records
    8TIN and Name combination matches IRS SSN and EIN records
    10Login denied: Invalid User Login and/or Password
    11Invalid Data
    12Invalid Configuration
    13Invalid TIN Matching request
    14Duplicate TIN Matching request
    15Connection Problem
    16IRS Connection Problem
    17IRS Tin/Name Validation temporarily unavailable
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account
    20Processing Error
    21IRS Processing Error
    22Invalid IRS Login
    23Login denied: Invalid User
    24Login denied: Invalid Password
    25Login denied: This Account has been locked
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts
    27Login denied: Terms not accepted
    28Login denied: Account Expired
    29Login denied: No Security rights
    DMF_CODEDMF_DETAILSXML Decode(DMF_DATA)
    -1Death Master File Match Not Processed 
    0No Death Master File Match Found 
    1Possible Death Master File Match FoundDetails
    10Login denied: Invalid User Login and/or Password 
    11Invalid Data 
    12Invalid Configuration 
    13Invalid Death Master File Matching request 
    15Connection problem 
    16DMF Connection Problem 
    17Death Master File Match temporarily unavailable 
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account 
    20Processing Error 
    21Death Master File Processing Error 
    23Login denied: Invalid User 
    24Login denied: Invalid Password 
    25Login denied: This Account has been locked 
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts 
    27Login denied: Terms not accepted 
    28Login denied: Account Expired 
    29Login denied: No Security rights
    EIN_CODEEIN_DETAILSEIN_DATA
    -1EIN Match Not Processed 
    0No EIN Match found. 
    1EIN Possible Match found.Details (EIN Name)
    10Login denied: Invalid User Login and/or Password 
    11Invalid Data 
    12Invalid Configuration 
    13Invalid Death Master File Matching request 
    15Connection problem 
    16DMF Connection Problem 
    17Death Master File Match temporarily unavailable 
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account 
    20Processing Error 
    21Death Master File Processing Error 
    23Login denied: Invalid User 
    24Login denied: Invalid Password 
    25Login denied: This Account has been locked 
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts 
    27Login denied: Terms not accepted 
    28Login denied: Account Expired 
    29Login denied: No Security rights
    StatusDetails
    OKSystem is functioning normally
    CallsRemainingDetails
    No LimitMonthly Plan
    NumberChecks Remaining

  • ValidateTinNameAddressListMatch (Click to Expand) : This method runs all the TINCheck validations at once. IRS TIN/Name, USPS address, DMF, OFAC, and the casino barred lists.

    Input
    [TinName]
    <TIN>(Required for IRS and DMF): The subjects 9 digit TIN (EIN or SSN), unformatted.
    <LName>: The subjects last name if parsed or the subjects full name (First Last) or the full Company name.
    <FName>(Optional): The subjects first name if parsed.
    <GIIN>(Optional): The subjects FATCA\FFI GIIN.
    <Encryption>: empty
    [USPSAddress]
    <Address1>(Optional): Suite/Apt Number
    <Address2>: Street Address
    <City>: Address City
    <State>: Address State
    <Zip5>: Zip Code
    <Zip4>*(Optional): Zip+4 Part
    [CurUser]
    <UserID>: empty
    <UserLogin>: TINCheck Login
    <UserPassword>: TINCheck Password
    <UserEncryption>: empty

    Output
    [ValidateTinNameAddressListMatchResult]
    <REQUESTID>: See table
    <REQUEST_STATUS>: See table
    <REQUEST_DETAILS>: See table
    [TINNAME_RESULT]
    <TINNAME_CODE>: See table
    <TINNAME_DETAILS>: See table
    <DMF_CODE>: See table
    <DMF_DETAILS>: See table
    <DMF_DATA>: See table
    <EIN_CODE>: See table
    <EIN_DETAILS>: See table
    <EIN_DATA>: See table
    [LISTMATCH_RESULT]
    -><LISTSMATCH_CODE>: See table
    -><LISTSMATCH_DETAILS>: See table
    ->[XXXX_RESULT] (Legacy): OFAC_RESULT, NV_RESULT, MS_RESULT, IL_RESULT, MO_RESULT, NJ_RESULT, EPLS_RESULT, DPL_RESULT, PEP_RESULT, and HHS_RESULT.
    -><XXXX_CODE>: See table
    -><XXXX_DETAILS>: See table
    -><XXXX_COUNT>: See table
    -><XXXX_DATA>: See table
    ->[Results] (New): A list of Result.
    -->[Result] A Result.
    --><Type>: OFAC, PEP, PLC, IL, ISA, MO, MS, NJ, NV, SSI, UKE, UVL, DFTO, DPL, DTC, EAR, EPLS, EUS, FBIAVC, FBICA, FBICAC, FBICC, FBICEI, FBIDT, FBIMWT, FBISI, FBISTI, FBITMW, FBIVCM, FBIWCC, FFI, FSE, GIIN, HHS, and IEO.
    --><Code>: See table
    --><Details>: See table
    --><Count>: See table
    --><Data>: See table
    [STATUS] Web service status
    <Status>: See table
    <CallsRemaining>: See table

    REQUESTIDREQUEST_STATUSREQUEST_DETAILS
    ID Number-1Request Not Processed
    0Request In Process
    1Request Completed
    2Request Exist in DB
    3Request sent to Authority
    10Login denied: Invalid User Login and/or Password
    11Invalid Data
    12Invalid Company Configuration: Tin/Name, List Match and Address Validations are disabled
    13Invalid Request
    14Duplicate Request
    15Connection Problem
    17Service temporarily unavailable
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account
    20Processing Error
    23Login denied: Invalid User
    24Login denied: Invalid Password
    25Login denied: This Account has been locked
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts
    27Login denied: Terms not accepted
    28Login denied: Account Expired
    29Login denied: No Security rights
    TINNAME_CODETINNAME_DETAILS
    -1Tin/Name Validation Not Processed
    0TIN and Name combination does not match IRS records
    1TIN and Name combination matches IRS records
    5TIN entered is not currently issued
    6TIN and Name combination matches IRS SSN records
    7TIN and Name combination matches IRS EIN records
    8TIN and Name combination matches IRS SSN and EIN records
    10Login denied: Invalid User Login and/or Password
    11Invalid Data
    12Invalid Configuration
    13Invalid TIN Matching request
    14Duplicate TIN Matching request
    15Connection Problem
    16IRS Connection Problem
    17IRS Tin/Name Validation temporarily unavailable
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account
    20Processing Error
    21IRS Processing Error
    22Invalid IRS Login
    23Login denied: Invalid User
    24Login denied: Invalid Password
    25Login denied: This Account has been locked
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts
    27Login denied: Terms not accepted
    28Login denied: Account Expired
    29Login denied: No Security rights
    DMF_CODEDMF_DETAILSXML Decode(DMF_DATA)
    -1Death Master File Match Not Processed 
    0No Death Master File Match Found 
    1Possible Death Master File Match FoundDetails
    10Login denied: Invalid User Login and/or Password 
    11Invalid Data 
    12Invalid Configuration 
    13Invalid Death Master File Matching request 
    15Connection problem 
    16DMF Connection Problem 
    17Death Master File Match temporarily unavailable 
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account 
    20Processing Error 
    21Death Master File Processing Error 
    23Login denied: Invalid User 
    24Login denied: Invalid Password 
    25Login denied: This Account has been locked 
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts 
    27Login denied: Terms not accepted 
    28Login denied: Account Expired 
    29Login denied: No Security rights
    EIN_CODEEIN_DETAILSEIN_DATA
    -1EIN Match Not Processed 
    0No EIN Match found. 
    1EIN Possible Match found.Details (EIN Name)
    10Login denied: Invalid User Login and/or Password 
    11Invalid Data 
    12Invalid Configuration 
    13Invalid Death Master File Matching request 
    15Connection problem 
    16DMF Connection Problem 
    17Death Master File Match temporarily unavailable 
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account 
    20Processing Error 
    21Death Master File Processing Error 
    23Login denied: Invalid User 
    24Login denied: Invalid Password 
    25Login denied: This Account has been locked 
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts 
    27Login denied: Terms not accepted 
    28Login denied: Account Expired 
    29Login denied: No Security rights
    LISTSMATCH_CODELISTSMATCH_DETAILS
    -1Lists Match Not Processed
    0No Lists Matches Found
    1Possible Lists Matches Found
    10Login denied: Invalid User Login and/or Password
    11Problem processing List Match Vaidation request: Invalid Data. {Details}
    12Invalid Configuration: No Lists enabled
    13Invalid Lists Matching request
    15Connection problem
    16Lists Connection Problem
    17Lists Match temporarily unavailable
    18Request denied: no more checks available for this account. Please, contact TinCheck to renew your account
    20Processing Error
    21Lists Match Processing Error
    23Login denied: Invalid User
    24Login denied: Invalid Password
    25Login denied: This Account has been locked
    26Login denied: Account Locked for 24-Hours: 3 or more Login attempts
    27Login denied: Terms not accepted
    28Login denied: Account Expired
    29Login denied: No Security rights
    XXXX_CODEXXXX_DETAILSXXXX_COUNTXML Decode(XXXX_DATA)
    0No Lists Matches Found0 
    1XXXX List: Possible X Matches Found.XDetails
    TypeCodeDetailsCountXML Decode(Data)
    XXXX0No Lists Matches Found0 
    XXXX1XXXX List: Possible X Matches Found.XDetails
    StatusDetails
    OKSystem is functioning normally
    CallsRemainingDetails
    No LimitMonthly Plan
    NumberChecks Remaining

Data Requirements

  • TIN: 9-digit numeric, required for TIN/Name and DMF.

  • LName: FName + LName is a 250 character string. Enter the full name (First Last) or full company name. Required for TIN/Name and list matches. The TIN/Name match uses the first 40 characters, all other lists use all characters.

  • FName: Optional, FName + LName is a 250 character string. Internally appended to LName when necessary.

  • GIIN: Optional, 19-alphanumeric, Example XXXXXX.XXXXX.XX.XXX

  • Address1: Optional, 38 character string. For the Suite/Apt part of the address.

  • Address2: 38 Character string. Required for USPS address validation. This is the street number and name part of the address.

  • City: 15 Character string.

  • State: 2 Character alpha only.

  • Zip5: 5 Digit only. For the 90210-1234 part of the zip code.

  • Zip4: 4 Digit only. For the 90210-1234 part of the zip code.

Web Service Links

Visual Studio 2010 .Net Sample Projects

PHP Sample Project

TINCheck SQL CLR Stored Procedure (MS SQL 2005+)

Example Usage: Result Output Table:
exec TINCheck_SP
@UserLogin = 'TINCheck UserID',
@Password = 'TINCheck Password',
@TIN = '587845148',
@Fname = '',
@Lname = '1099 Pro',
@Address1 = '4th Floor',
@Address2 = '200 Ballardvale Street',
@City = 'Wilmington',
@State = 'MA',
@Zip5 = '01887',
@Zip4 = ''
 -REQUESTID
-REQUEST STATUS
-REQUEST DETAILS
-TINNAME CODE
-TINNAME DETAILS
-DMF CODE
-DMF DETAILS
-OFAC CODE
-OFAC DETAILS
-OFAC COUNT
-ADDRESS CODE
-ADDRESS DETAILS
local