> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Businesses with Tour

> Retrieve all Nexudus locations that have the space tour booking feature enabled.

# List Businesses with Tour

Returns all locations in the network where the space tour feature is active. The portal uses this to determine which locations a prospective member can book a tour at, and to build location pickers in the tour booking flow.

## Authentication

Requires a valid customer bearer token.

## Query Parameters

<ParamField query="_shape" type="string">
  Comma-separated list of field paths to include in the response. When provided, only the
  specified fields are returned — useful for reducing payload size. Supports nested paths
  using dot notation. Example: `_shape=Businesses.Name,Businesses.WebAddress`.
</ParamField>

## Response

<ResponseField name="Businesses" type="array">
  Array of location objects for locations that have the tour feature enabled.
</ResponseField>

<ResponseField name="Businesses[].Id" type="number">
  Unique numeric identifier for the location.
</ResponseField>

<ResponseField name="Businesses[].UniqueId" type="string">
  Globally unique identifier (GUID) for the location.
</ResponseField>

<ResponseField name="Businesses[].Name" type="string">
  Display name of the location.
</ResponseField>

<ResponseField name="Businesses[].WebAddress" type="string">
  Subdomain identifier for the location (e.g. `"myspace"`).
</ResponseField>

## Example Response

```json theme={null}
{
  "Businesses": [
    {
      "Id": 1,
      "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "Name": "Main Location",
      "WebAddress": "mainlocation"
    }
  ]
}
```

## TypeScript Integration

```typescript theme={null}
import endpoints from '@/api/endpoints'
import { useTypedData } from '@/api/fetchData'
import { AllLocations } from '@/types/AllLocations'

const endpoint = endpoints.system.business.withTour()
// endpoint.type is { Businesses: AllLocations[] }

const { resource } = useTypedData(httpClient, endpoint)
const tourLocations = resource?.Businesses ?? []
```

## Usage in Portal

| Context                            | Source file                         |
| ---------------------------------- | ----------------------------------- |
| Space tour booking location picker | `src/views/tours/` or checkout flow |

## Error Responses

<ResponseField name="401 Unauthorized" type="error">
  The bearer token is missing, expired, or invalid.
</ResponseField>

## Related Endpoints

| Method | Endpoint                              | Description                              |
| ------ | ------------------------------------- | ---------------------------------------- |
| `GET`  | `/api/public/businesses/current`      | Get the current location                 |
| `GET`  | `/api/public/businesses/all`          | List all locations in the network        |
| `GET`  | `/api/public/businesses/withVisitors` | List locations with visitor registration |