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

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

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

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

1. Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application) for the application.
2. Set `provider` to `tax_status_verify_individual`.
3. Include the applicable underwriting `stage_id` when required by the application's 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_individual`.
6. 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

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

<Warning>
  `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.
</Warning>

## 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](/api-docs/docs/error-handling-external-data-provider-status-messages) for shared provider-status guidance.

## FAQ

<AccordionGroup>
  <Accordion title="Which application fields are required?">
    The primary business owner must have a valid SSN and a last name.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Can I run TaxStatus Verify Individual in Data Orchestration?">
    No. It is not currently registered as a Data Orchestration service.
  </Accordion>
</AccordionGroup>