> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lendflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TaxStatus Verify Business

## 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.

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

## 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

1. Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application).
2. Set `provider` to `tax_status_verify_business`.
3. Include the applicable underwriting `stage_id` when required by the workflow.
4. Confirm that the response contains `data.onqueue: true`.
5. Poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data) with `services[]=tax_status_verify_business`.

```json theme={"system"}
{
  "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`.

<Note>
  TaxStatus Verify Business is not included in the current Data Orchestration service catalog.
</Note>

## 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

```json theme={"system"}
{
  "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. |

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

## 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

<AccordionGroup>
  <Accordion title="Which application fields are required?">
    The business must have a valid EIN and legal name.
  </Accordion>

  <Accordion title="Does this service retrieve IRS transcripts?">
    No. It only verifies whether the EIN and business name match within the IRS system.
  </Accordion>

  <Accordion title="Can this service run in Data Orchestration?">
    It is not included in the current Data Orchestration service catalog.
  </Accordion>
</AccordionGroup>