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

# Yellow Pages Business Search

## Yellow Pages Business Search

Yellow Pages Business Search looks for a company in Yellow Pages directory data. The **Yellow Pages** Workflow Builder block exposes the `yellow_pages` 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 Yellow Pages Business Search

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

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

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

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

## What the service returns

| Response area | Meaning |
| - | - |
| Response array | Candidate Yellow Pages listings. |
| Listing identity and contact fields | Name, directory URL, address, telephone, and website. |
| Listing metadata | Hours, ratings, review count, categories, social networks, description, and payment information. |

## Representative response

```json theme={"system"}
[
  {
    "id": "564553485",
    "name": "Example Travel",
    "url": "https://www.yellowpages.com/example",
    "address": "3050 N Main St",
    "city": "Boise",
    "state": "ID",
    "zip": "83703",
    "phone": "2085550100",
    "website": "https://example.com",
    "open24": false,
    "rating": 4,
    "reviews": 12,
    "score": 78.4,
    "hoursText": "Mon - Fri 9:00 am - 5:00 pm",
    "features": {
      "socialNetworks": [
        "https://www.facebook.com/example"
      ]
    },
    "description": "Business description.",
    "сategories": [
      "Travel Agencies"
    ],
    "paymentMethod": null
  }
]
```

<Warning>
  The current provider fixture spells `сategories` with a Cyrillic `с`, not a Latin `c`. Read the exact returned key and do not silently assume `categories`.
</Warning>

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `[]` | Array | Candidate Yellow Pages listings. | Zero or more listing objects. | On a successful lookup. |
| `[].id` | String | Yellow Pages listing identifier. | Provider identifier. | For each listing when available. |
| `[].name` | String | Listing name. | Provider text. | For each listing. |
| `[].url` | String or null | Yellow Pages listing URL. | URL text. | When available. |
| `[].address`, `[].city`, `[].state`, `[].zip` | Strings or null | Directory address components. | Provider text. | When available. |
| `[].phone` | String or null | Listing telephone. | The fixture uses digits-only text; formatting is not guaranteed. | When available. |
| `[].website` | String or null | Business website. | URL text. | When available. |
| `[].open24` | Boolean or null | Whether the listing indicates 24-hour operation. | `true` or `false`. | When available. |
| `[].rating` | Number or null | Directory rating. | Displayed on a five-star control; exact bounds are not validated. | When available. |
| `[].reviews` | Number or null | Review count. | Non-negative count. | When available. |
| `[].score` | Number or null | Upstream match or relevance score. | Formula, range, and unit are not defined. | When available. |
| `[].hoursText` | String or null | Provider-formatted operating hours. | Text. | When available. |
| `[].features.socialNetworks` | Array of strings or null | Social profile URLs. | Zero or more URLs. | When available. |
| `[].description` | String or null | Directory description. | Provider text that can contain HTML; render safely. | When available. |
| `[].сategories` | Array of strings | Directory category labels. | Note the Cyrillic first character in the observed key. | When available. |
| `[].paymentMethod` | String or null | Provider-supplied payment information. | Provider text. | When available. |
| `error` | String | Failure or no-result message. | Service-generated text. | When the lookup fails. |

## Errors and statuses

`statuses.yellow_pages` 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 Yellow Pages 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>