TaxStatus Verify Individual

TaxStatus Verify Individual checks whether a primary business owner’s SSN and last name match within the IRS system. It verifies a name-and-TIN match; it does not prove possession of the identity or retrieve the individual’s IRS transcripts. The Tax Status block is available for individual entities in the KYC category.

TaxStatus is a bring-your-own-credentials service. Your organization must connect an active TaxStatus client_id and client_secret before running it.

Requirements

Application field	Requirement	Notes
Primary owner SSN	Required	Formatting is removed before the taxpayer match.
Primary owner last name	Required	Used with the SSN for the taxpayer match.

Address, telephone, email, and date of birth are not used for this service.

Run TaxStatus Verify Individual through the API

Call Enrich Business Credit Application for the application.
Set provider to tax_status_verify_individual.
Include the applicable underwriting stage_id when required by the application’s workflow.
Confirm that the response contains data.onqueue: true.
Poll Get Commercial Data with services[]=tax_status_verify_individual.
Check data.statuses.tax_status.individual.verify for completion and read data.commercial_data.tax_status.individual.verify.

The request runs asynchronously. data.onqueue: true means the job was queued, not that TaxStatus or the IRS has finished.

Data Orchestration availability

TaxStatus Verify Individual is not currently available as a Data Orchestration service. Run it through the KYC Workflow Builder block or the application enrichment API.

Sample response

{
  "data": {
    "statuses": {
      "tax_status": {
        "individual": {
          "verify": "Success"
        }
      }
    },
    "commercial_data": {
      "tax_status": {
        "individual": {
          "verify": {
            "TIN": "*****1234",
            "Result": "valid"
          }
        }
      }
    },
    "request_data": {
      "tax_status": {
        "individual": {
          "verify": {
            "companyId": "example-company-id",
            "tin": "*****1234",
            "isCompany": 0,
            "lastNameOrBusiness": "Doe"
          }
        }
      }
    }
  }
}

Response attributes

Attribute	Type	Meaning
`data.statuses.tax_status.individual.verify`	String	Latest Lendflow service lifecycle status or terminal provider message.
`data.commercial_data.tax_status.individual.verify`	Object	TaxStatus Verify Individual response.
`TIN`	String	Taxpayer identification number echoed by TaxStatus. It is masked in the sample on this page.
`Result`	String	TaxStatus provider result.
`data.request_data.tax_status.individual.verify`	Object	Request payload stored and returned by Lendflow.
`companyId`	String	TaxStatus enterprise identifier supplied by Lendflow.
`tin`	String	Primary owner’s submitted SSN. Lendflow can return the complete value; it is masked only in this documentation example.
`isCompany`	Number	`0` for an individual verification.
`lastNameOrBusiness`	String	Primary owner’s last name used for matching.

data.request_data.tax_status.individual.verify.tin and the provider’s TIN response can contain the complete SSN. Restrict access to the commercial-data response and do not log or expose these values.

TaxStatus result values

`Result`	Meaning	Action
`valid`	The SSN and last name match within the IRS system.	Apply your organization’s KYC policy.
`invalid`	The request completed, but the SSN and last name did not match.	Verify the owner’s SSN and last name before rerunning.
`queued`	TaxStatus accepted the request, but the IRS result is not ready.	TaxStatus indicates that this uncommon response can usually be retried immediately.
`IRS system offline`	The IRS verification system is unavailable.	Retry later.
`IRS system down`	TaxStatus uses this value in an example response, although its documented value list says `IRS system offline`.	Retry later.

Lendflow stores the provider response verbatim. Use the exact lowercase valid value documented by TaxStatus; do not rely on alternate casing from local test fixtures.

Lendflow service statuses

The Lendflow status and the TaxStatus Result answer different questions. Success means Lendflow stored the provider response; it does not mean the name-and-SSN match was valid.

Lendflow status or message	Meaning	Action
`Not yet started`	Lendflow has not started the service.	Start the service when the deal is ready.
`Started`	The asynchronous Lendflow job is running.	Continue polling.
`Success`	Lendflow stored a TaxStatus response.	Read `data.commercial_data.tax_status.individual.verify.Result`.
`Taxpayer not found.`	TaxStatus did not find the taxpayer.	Verify the submitted identity information.
`Waiting on IRS`	Lendflow received a provider response indicating that the IRS result is pending.	Retry later.
`Something went wrong while searching.`	The request failed without a more specific message.	Retry and contact Lendflow if it continues.

See Data Provider Status Messages for shared provider-status guidance.

FAQ

Which application fields are required?

The primary business owner must have a valid SSN and a last name.

Does this service retrieve IRS transcripts?

No. It verifies whether an individual’s SSN and last name match within the IRS system. IRS transcript retrieval is a separate tax-data service.

Does an invalid result mean the API call failed?

No. invalid means TaxStatus completed the request but did not validate the submitted SSN and last name.

Can I run TaxStatus Verify Individual in Data Orchestration?

No. It is not currently registered as a Data Orchestration service.