TaxStatus Verify Business

TaxStatus Verify Business checks whether a business EIN and legal name match within the IRS system. It verifies a name-and-TIN match; it does not retrieve IRS transcripts. The Tax Status KYB Workflow Builder block exposes the tax_status_verify_business service.

TaxStatus is a bring-your-own-credentials service. Your organization must connect active TaxStatus credentials before the service can run.

Requirements

Application field	Requirement	Notes
Business EIN	Required	Must be a valid EIN; Lendflow removes formatting before verification.
Business legal name	Required	Matched with the EIN in IRS records.

Run TaxStatus Verify Business

Call Enrich Business Credit Application.
Set provider to tax_status_verify_business.
Include the applicable underwriting stage_id when required by the workflow.
Confirm that the response contains data.onqueue: true.
Poll Get Commercial Data with services[]=tax_status_verify_business.

{
  "provider": "tax_status_verify_business"
}

The provider result appears at commercial_data.tax_status.business.verify, the lifecycle message appears at statuses.tax_status.business.verify, and the stored request appears at request_data.tax_status.business.verify.

TaxStatus Verify Business is not included in the current Data Orchestration service catalog.

What the service returns

Response area	Meaning
`commercial_data.tax_status.business.verify`	TaxStatus’s taxpayer match result.
`request_data.tax_status.business.verify`	The exact verification inputs stored by Lendflow.
`statuses.tax_status.business.verify`	Lendflow lifecycle status or terminal provider message.

Representative response

{
  "data": {
    "statuses": {
      "tax_status": {
        "business": {
          "verify": "Success"
        }
      }
    },
    "commercial_data": {
      "tax_status": {
        "business": {
          "verify": {
            "TIN": "*****6789",
            "Result": "valid"
          }
        }
      }
    },
    "request_data": {
      "tax_status": {
        "business": {
          "verify": {
            "companyId": "example-company-id",
            "tin": "*****6789",
            "isCompany": 1,
            "lastNameOrBusiness": "Example Business LLC"
          }
        }
      }
    }
  }
}

Response attributes

Attribute	Type	Meaning	Possible values or units	When returned
`TIN`	String	EIN echoed by TaxStatus.	Sensitive identifier; masked only in this example.	When returned by TaxStatus.
`Result`	String	TaxStatus match result.	`valid`, `invalid`, `queued`, or an IRS availability message.	On a provider response.
`companyId`	String	TaxStatus enterprise identifier supplied by Lendflow.	Configured identifier.	In stored request data.
`tin`	String	Submitted business EIN.	Can contain the complete EIN.	In stored request data.
`isCompany`	Number	Indicates business verification.	`1`.	In stored request data.
`lastNameOrBusiness`	String	Business legal name used for matching.	Application business name.	In stored request data.

The provider TIN and stored request tin can contain the complete EIN. Restrict access and do not log or expose these values.

Result values and statuses

Value	Meaning
`valid`	The EIN and business name match within the IRS system.
`invalid`	The request completed, but the EIN and business name did not match.
`queued` or `Waiting on IRS`	The IRS result is not ready. Retry later.
`IRS system offline` or `IRS system down`	IRS verification is unavailable. Retry later.
`Taxpayer not found.`	TaxStatus did not find a matching taxpayer.

Success is a Lendflow lifecycle status and does not mean Result is valid.

FAQ

Which application fields are required?

The business must have a valid EIN and legal name.

Does this service retrieve IRS transcripts?

No. It only verifies whether the EIN and business name match within the IRS system.

Can this service run in Data Orchestration?

It is not included in the current Data Orchestration service catalog.