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

# Experian Business Quick Search

## Experian Business Quick Search

Experian Business Quick Search finds candidate U.S. businesses from one application value and returns Experian Business Identification Numbers (BINs), names, addresses, telephone numbers, contacts, and provider ranking values. The Workflow Builder block is `ExperianQuickSearch`, and its service ID is `experian_business_quick_search`.

## Requirements

| Application field | Requirement | Notes |
| - | - | - |
| Business legal name | Conditional | Required when **Business legal name** is selected as the search source. This is the default selection, and the value must not be empty. |
| Business address | Conditional | Required when **Business address** is selected. At least one address component must be present; available address lines, city, normalized state, and ZIP code are combined for the search. |
| Primary business owner's telephone | Conditional | Required and must not be empty when **Business telephone** is selected. |
| Primary business owner's full name | Conditional | Required and must not be empty when **Contact name** is selected. |
| Existing Experian BIN | Conditional | Required and must already be stored on the business when **BIN** is selected. |

The selected search source must resolve to a non-empty string.

## API flow

1. Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application).
2. Set `provider` to `experian_business_quick_search`.
3. Optionally set `options.searchString` to one of the values above. `stage_id` is optional; when supplied, it must be a valid underwriting workflow-stage UUID for the application.
4. Treat `{"data":{"onqueue":true}}` as queue acceptance, not a completed search.
5. Poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data) with `services[]=experian_business_quick_search`.

```json theme={"system"}
{
  "provider": "experian_business_quick_search",
  "options": {
    "searchString": "business_legal_name"
  },
  "stage_id": "6ff8f7f6-1eb3-3525-be4a-3932c805afed"
}
```

| Data | API response path |
| - | - |
| Stored provider response | `commercial_data.experian.business_quick_search` |
| Lifecycle message | `statuses.experian.business_quick_search` |
| Stored request | `request_data.experian.business_quick_search` |

The API queues a background job. That job authenticates with Experian, performs the provider request, stores the response, and updates the business's Experian BIN from the first returned result when available.

## Data Orchestration availability and flow

Experian Business Quick Search is available in Data Orchestration under **Match > Experian > Quick Search**.

1. Add the Experian Quick Search service step and configure a condition that checks whether a business match exists.
2. Choose the quick-search source when needed. Data Orchestration defaults to the business legal name.
3. If prerequisite Quick Search data is absent, Data Orchestration runs the service synchronously before evaluating the condition.
4. The condition evaluates the first non-empty result. An empty result or Experian's no-records message evaluates as no match.

## What the service returns

| Response area | Meaning |
| - | - |
| Candidate array | Zero or more Experian business candidates. |
| Business identity | BIN and business name for each candidate. |
| Contact information | Telephone, contact name, and contact title when Experian supplies them. |
| Address information | Street, city, state, and five-digit ZIP when supplied. |
| Ranking | Provider ranking value for ordering candidate results. Lendflow does not define a public decision threshold for it. |

## Representative response

```json theme={"system"}
[
  {
    "bin": "700000001",
    "busName": "EXAMPLE BUSINESS LLC",
    "rank": 50400,
    "phone": "+15125550100",
    "contact": "JANE DOE",
    "contactTitle": "OWNER",
    "street": "100 MAIN ST",
    "city": "AUSTIN",
    "state": "TX",
    "zip5": "78701",
    "displayOtherBusNames": []
  }
]
```

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `[].bin` | String | Experian Business Identification Number. | Identifier text; preserve leading zeroes. | For a candidate when supplied. |
| `[].busName` | String | Candidate business name. | Provider text. | For each returned candidate. |
| `[].rank` | Number | Experian's candidate ranking value. | Provider-defined numeric value; no Lendflow pass threshold is defined. | For each returned candidate in the current fixture. |
| `[].phone` | String | Candidate telephone. | Provider-formatted telephone text; it can be an empty string. | When supplied. |
| `[].contact` | String | Contact associated with the candidate. | Provider text or an empty string. | When supplied. |
| `[].contactTitle` | String | Contact's title. | Provider text or an empty string. | When supplied. |
| `[].street` | String | Candidate street address. | Provider text. | When supplied. |
| `[].city` | String | Candidate city. | Provider text. | When supplied. |
| `[].state` | String | Candidate state. | Two-letter code in the current fixture. | When supplied. |
| `[].zip5` | String | Candidate five-digit ZIP code. | String; preserve leading zeroes. | When supplied. |
| `[].displayOtherBusNames` | Array | Other business names attached to the candidate. | Zero or more provider-controlled values. | When supplied; it can be empty. |

## Errors and statuses

* An unsupported `options.searchString` value fails Lendflow request validation.
* A selected application value that resolves to `null` or an empty string fails provider-request validation.
* Inactive or invalid Experian credentials, a missing subcode, authentication failures, and provider HTTP errors cause the queued job to fail.
* No candidates produces `No Business found - {business name}`. This is different from a provider transport error.
* `Success` means Lendflow stored the search results. It is not an underwriting decision.

## FAQ

<AccordionGroup>
  <Accordion title="Which search source is used by default?">
    Lendflow uses `business_legal_name` when `options.searchString` is omitted.
  </Accordion>

  <Accordion title="Does queue acceptance mean the search finished?">
    No. `data.onqueue=true` only confirms that the background job was queued. Poll Commercial Data until the lifecycle message reaches a terminal state.
  </Accordion>

  <Accordion title="Does the service update the application BIN?">
    Yes. When Experian returns a candidate, Lendflow stores the BIN from the first result on the business.
  </Accordion>

  <Accordion title="Can Data Orchestration run the search?">
    Yes. It can fetch missing prerequisite data synchronously and evaluate whether the first result contains a business match.
  </Accordion>
</AccordionGroup>
