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

# Foursquare Business Search

## Foursquare Business Search

Foursquare Business Search looks for a company in Foursquare place and business-listing data. The **Foursquare** Workflow Builder block exposes the `foursquare` 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 Foursquare Business Search

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

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

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

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

## What the service returns

| Response area | Meaning |
| - | - |
| Response array | Candidate Foursquare places. |
| `location` | Street, locality, region, and postal-code information. |
| Categories and features | Provider categories, payment methods, and other venue features. |
| Hours and contact fields | Operating hours, telephone, website, and social profiles. |
| `photos` | Components used to construct provider image URLs. |

## Representative response

```json theme={"system"}
[
  {
    "name": "Example Business",
    "fsq_id": "5069dfe3e4b029655d7903f6",
    "location": {
      "address": "475 Anton Blvd",
      "locality": "Costa Mesa",
      "region": "CA",
      "postcode": "92626"
    },
    "description": "Provider description",
    "categories": [
      {
        "name": "Financial Service"
      }
    ],
    "features": {
      "payment": {
        "credit_cards": {
          "visa": true,
          "amex": true
        }
      }
    },
    "hours": {
      "display": "Mon 9:00 AM-5:00 PM",
      "regular": [
        {
          "day": 1,
          "open": "0900",
          "close": "1700"
        }
      ]
    },
    "score": 42.8,
    "tel": "(949) 555-0100",
    "website": "https://example.com",
    "social_media": {
      "twitter": "example"
    }
  }
]
```

The result is an array of possible places, not a verified single match. Optional fields can be omitted or empty.

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `[]` | Array | Candidate Foursquare places. | Zero or more place objects. | On a successful lookup. |
| `[].name` | String or null | Place name. | Provider text. | When available. |
| `[].fsq_id` | String or null | Foursquare place identifier. | Provider identifier. | When available. |
| `[].location` | Object or null | Place address. | Can contain `address`, `locality`, `region`, and `postcode`. | When available. |
| `[].description` | String or null | Provider description. | Provider text. | When available. |
| `[].categories` | Array | Place categories. | Items can contain `name`. | When available. |
| `[].features.payment.credit_cards` | Object or null | Accepted-card indicators. | Boolean map such as `visa`, `amex`, or `master_card`. | When available. |
| `[].hours.display` | String or null | Provider-formatted hours. | Text. | When available. |
| `[].hours.regular` | Array | Structured weekly hours. | `day` uses `1` through `7`; `open` and `close` use `HHMM` in the fixture. | When available. |
| `[].score` | Number or null | Upstream match or ranking score. | Scale and business meaning are not defined in the repositories. | When available. |
| `[].tel` | String or null | Place telephone. | Provider-formatted text. | When available. |
| `[].website` | String or null | Place website. | URL text. | When available. |
| `[].social_media` | Object or null | Social profile identifiers. | Provider-controlled key/value object. | When available. |
| `[].photos` | Array | Photo URL components. | Each usable item contains `prefix` and `suffix`. | When available. |
| `error` | String | Failure or no-result message. | Service-generated text. | When the lookup fails. |

## Errors and statuses

`statuses.foursquare` 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 Foursquare 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>