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

# Browse Directory

> Browse the business directory

Browse member companies and service providers.

## Search & Filter

* **Search** - By company name, keyword
* **Category** - Filter by industry
* **Location** - Filter by region or radius
* **Services** - Filter by service type

## Company Listings

Each listing shows:

* Company name and logo
* Description
* Location
* Services offered
* Contact information

## Map view (Google Maps)

The directory can optionally provide a store-locator style experience:

* Map pins for directory listings
* Search by address/suburb/postcode
* Radius filtering (e.g. 5km, 10km, 50km)
* "Search this area" behavior

Listings require a geocoded address (latitude/longitude) to appear on the map.

## Contact Company

Submit inquiry through contact form:

* Your details auto-filled
* Message to company
* Company receives lead notification

## Features

### Browse Directory

#### Acceptance Criteria

##### Frontend

* [ ] UI supports the workflows described in this feature.

##### Backend / API

* [ ] Backend behavior supports this feature as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

## Implementation Contracts

### Backend (API)

```
GET    /api/directory                        # List companies
GET    /api/directory/{id}                   # Company details
POST   /api/directory/{id}/contact           # Submit inquiry
GET    /api/directory/categories             # Categories
```