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

# BBB Business Search

## BBB Business Search

BBB Business Search looks for a business in Better Business Bureau data. The **BBB** Workflow Builder block exposes the `bbb` 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 BBB Business Search

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

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

The request is asynchronous. Read the provider result from `commercial_data.bbb`, the lifecycle message from `statuses.bbb`, and the stored request from `request_data.bbb`.

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

## What the service returns

| Response area | Meaning |
| - | - |
| Complete response | Raw BBB data returned by the Data Graph service. Lendflow does not normalize it to a fixed schema. |

## Representative response

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

The current Lendflow repository does not contain a production-like BBB fixture or field-level model. Clients must treat the result as an opaque JSON value and tolerate object-shape changes, omitted fields, and `null`.

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| Root value | Object or null | Raw BBB lookup result. | Upstream Data Graph response; fields are not defined in the current repositories. | After completion when data is stored. |
| `error` | String | Failure or no-result message. | Service-generated text. | When the lookup fails. |

## Errors and statuses

`statuses.bbb` is a Lendflow lifecycle status, not a BBB rating. `Started` means processing is pending; `Success` means a response was stored. A response containing `error` marks the request as failed.

## FAQ

<AccordionGroup>
  <Accordion title="Is a BBB rating guaranteed?">
    No. The service can complete successfully even when the matched profile does not contain a rating or accreditation information.
  </Accordion>

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