API Endpoint: Validate

https://www.tincomply.com/api/v1/validate

The validate endpoint is the primary API endpoint, capable of processing all available validation types. You can either run all validations or restrict them by specifying the requestedServices parameter.

Supported Parameters

The following parameters can be included in a request to the validate endpoint:

tin – Taxpayer Identification Number
name – Entity or individual name
fatca – FATCA GIIN
lei – Legal Entity Identifier
suite – Suite or unit number
street – Street address
city – City name
state – State abbreviation
zip5 – 5-digit ZIP code
zip4 – ZIP+4 extension
requestedServices – List of validation processes to perform. If left blank then the endpoint will process all possible validations based on passed parameters.

Using `requestedServices`

The requestedServices parameter allows you to specify which validations to perform. It accepts a list of the following values:

irs-tin-name-matching – IRS TIN and name validation.
company-name-lookup-by-ein – Retrieve a company name using its EIN.
company-ein-lookup-by-name – Find an EIN using a company name.
address-validation – Verify and standardize an address.
fatca-giin – Validate a FATCA GIIN.
legal-entity-identifier – Validate an LEI.
list-sanctions – Screen against global sanctions lists.
company-details-lookup-by-name-address – Retrieve company details using name and address.

Response Object

The response format varies based on the requested validation services. Refer to the documentation for each of the other specific endpoints for the response details.

Sample Request

{
  "tin": "12-2433212",
  "name": "IBM CORPORATION",
  "giin": "29SR4B.99999.SL.372",
  "lei": "VGRQXHF3J8VDLUA7XE92",
  "suite": "",
  "street": "PO BOX 218",
  "city": "YORKTOWN HEIGHTS",
  "state": "NY",
  "zip5": "10598"
}

Sample Response

{
    "id": "ZfPjtFHAXEep29ZZTc5rpgj1",
    "request": {
        "tin": "XXXXX1985",
        "name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
        "giin": "29SR4B.99999.SL.372",
        "lei": "VGRQXHF3J8VDLUA7XE92",
        "street": "PO BOX 218",
        "suite": "",
        "city": "YORKTOWN HEIGHTS",
        "state": "NY",
        "zip5": "10598",
        "matchThreshold": 65,
        "requestDate": "2025-02-20T05:45:00Z",
        "requestedServices": "irs-tin-name-matching,company-name-lookup-by-ein,address-validation,fatca-giin,legal-entity-identifier,list-sanctions,company-details-lookup-by-name-address,company-ein-lookup-by-name"
    },
    "irsTinNameMatchingResult": {
        "message": "TIN and Name combination matches IRS EIN records",
        "result": 7,
        "completed": true
    },
    "companyNameLookupByEinResult": {
        "name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
        "message": "EIN lookup match found",
        "found": true,
        "completed": true
    },
    "addressValidationResult": {
        "street": "218 PO BOX",
        "suite": "",
        "city": "YORKTOWN HEIGHTS",
        "state": "NY",
        "zip5": "10598",
        "zip4": "0218",
        "dpbc": "18",
        "congressionalDistrict": "17",
        "countyName": "WESTCHESTER",
        "latitude": 0,
        "longitude": 0,
        "message": "Address was confirmed as valid",
        "completed": true,
        "found": true,
        "corrections": [
            "PO BOX match.",
            "ZIP+4 corrected."
        ]
    },
    "fatcaGiinResult": {
        "giin": "29SR4B.99999.SL.372",
        "name": "IBM Ireland Profit Sharing Scheme",
        "country": "IRELAND",
        "message": "GIIN match found",
        "found": true,
        "completed": true
    },
    "legalEntityIdentifierResult": {
        "lei": "VGRQXHF3J8VDLUA7XE92",
        "properties": {
            "names": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
            "topics": "corp.public",
            "address": "ONE NORTH CASTLE DRIVE, Armonk, US-NY 10504; ONE NORTH CASTLE DRIVE, ARMONK, US-NY 10504",
            "legalform": "Business Corporation",
            "registrationNumber": "30059",
            "jurisdiction": "United States",
            "leiCode": "VGRQXHF3J8VDLUA7XE92",
            "dateIncorporated": "1911-06-16",
            "status": "ACTIVE",
            "swiftBic": "IBMXUS33"
        }
    },
    "listSanctionsMatchResult": {
        "completed": true,
        "anyFiltered": false,
        "results": [{
            "name": "INTERNATIONAL BUSINESS MACHINES",
            "type": "Organization",
            "confidence": 75,
            "list": "Business Identifier Code (BIC) Reference Data",
            "properties": {
                "names": "INTERNATIONAL BUSINESS MACHINES",
                "address": "1 NEW ORCHARD RD ARMONK,NY ARMONK,NY 10504 UNITED STATES OF AMERICA; 1 NEW ORCHARD RD ARMONK 10504 UNITED STATES OF AMERICA",
                "sWIFTBIC": "IBMXUS33",
                "country": "United States"
            },
            "related": [],
            "relationships": []
        }]
    },
    "companyDetailsLookupByNameAddressResult": {
        "completed": true,
        "anyFiltered": false,
        "results": [{
            "name": "International Business Machines Corporation",
            "type": "Organization",
            "confidence": 100,
            "properties": {
                "names": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
                "address": "1 NEW ORCHARD RD, ARMONK, NY 10504-1722",
                "country": "United States",
                "latitude": "41.108932",
                "longitude": "-73.719025",
                "phonenumbers": "(914) 499-1900",
                "relatedWebsites": "https://www.ibm.com",
                "fax": "(914) 765-7382"
            }
        }]
    },
    "companyEinLookupByNameResult": {
        "completed": true,
        "results": [{
                "id": "kIBnBIgsE022jdmzRAKrYgbO15e142clmUSasX6Rr8UkdgKU",
                "name": "INTERNATIONAL BUSINESS MACHINES CORP",
                "ein": "13-XXXXX66",
                "confidence": 100
            },
            {
                "id": "3aw5invM9UKeWtqgLB8mcQKz4Hywib4SPEWOsoTXjqZCdADW",
                "name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
                "ein": "13-XXXXX85",
                "confidence": 100
            }
        ]
    }
}