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

# Yelp Business Search

## Yelp Business Search

Yelp Business Search looks for a company in Yelp business-listing data. The **Yelp** Workflow Builder block exposes the `yelp` service for business entities.

## Requirements

| Application field | Requirement | Notes |
| - | - | - |
| Business legal name | Required | Used as the company search term. |
| Business address city | Optional | Recommended to improve matching. |
| Business address state | Optional | Recommended to improve matching; use a state code. |

## Run Yelp Business Search

Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application) with `provider` set to `yelp`, then poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data) with `services[]=yelp`.

```json theme={"system"}
{
  "provider": "yelp"
}
```

The asynchronous result appears at `commercial_data.yelp`, the lifecycle message appears at `statuses.yelp`, and the stored request appears at `request_data.yelp`.

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

## What the service returns

| Response area | Meaning |
| - | - |
| Complete response | Raw Yelp data returned by the Data Graph service. Lendflow does not define whether it is an object or array. |

## Representative response

```json theme={"system"}
null
```

The current Lendflow repositories contain no Yelp response fixture or field-level model. The Dashboard treats this result as unknown JSON. Do not assume it follows the Yelp Fusion API.

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| Root value | Unknown JSON or null | Raw Yelp lookup result. | Object-versus-array shape and nested fields are not established. | After completion when data is stored. |
| `error` | String | Failure or no-result message. | Service-generated text. | When the lookup fails. |

## Errors and statuses

`statuses.yelp` describes the Lendflow request lifecycle. `Success` means a response was stored; it does not guarantee that every listing field was found. A response containing `error` marks the request as failed.

## FAQ

<AccordionGroup>
  <Accordion title="Why does the response schema vary?">
    Lendflow stores the upstream Yelp result without a fixed field-level normalization contract.
  </Accordion>

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