# Ibba — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and find professional business brokers from the IBBA directory by location or name, accessing their contact information, business details, and specialties across over 3,000 verified profiles. Discover brokers in your area or filter by geographic regions and service specialties to connect with the right professional for your business needs.

**Category:** Business Directories | **Website:** [ibba.org/](https://ibba.org/) | **Docs:** [parse.bot/marketplace/5a2fae5c-59a1-4366-95d6-d907d3831556/ibba-org-api](https://parse.bot/marketplace/5a2fae5c-59a1-4366-95d6-d907d3831556/ibba-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ibba-org-api-5a2fae5c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_broker_profile

Retrieve the full profile and contact details of a specific broker by name. Searches the directory and returns the best-matching broker profile. Use a real broker name (e.g. 'Brandon Smith'). Returns input_not_found if no match exists.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Broker name to look up (use full name like 'Brandon Smith') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibba-org-api-5a2fae5c/get_broker_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_geographic_regions

Returns US states and Canadian provinces with their corresponding IDs, broker counts, and slugs for geographic filtering.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibba-org-api-5a2fae5c/get_geographic_regions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_specialty_areas

Returns the list of specialty areas (industries) used for filtering brokers in the IBBA directory. Each specialty includes its slug (for use in the specialties filter on search_brokers_by_location) and the count of brokers with that specialty.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibba-org-api-5a2fae5c/get_specialty_areas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_all_brokers

Returns the complete directory of all business brokers listed on IBBA (approx 3,000 brokers) with full contact details in a single response. This is an expensive call that returns a large payload.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibba-org-api-5a2fae5c/list_all_brokers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_brokers_by_location

Search for business brokers by location with a configurable radius. Geocodes the location string via Mapbox, then queries the IBBA broker geo endpoint. Returns brokers within the specified area with contact details, distance from the search point, CBI certification status, and specialty areas.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cbi` | string | No | Filter by CBI certification. Pass '1' for certified only, empty string for all. |
| `location` | string | Yes | City, state, or address to search near (e.g. 'New York', 'Los Angeles, CA', '90210') |
| `radius` | integer | No | Search radius in miles |
| `specialties` | string | No | Comma-separated specialty area slugs to filter by (e.g. 'food-beverage,accommodations'). Valid slugs are returned by get_specialty_areas endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibba-org-api-5a2fae5c/search_brokers_by_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cbi":"<string>","location":"<string>","radius":"<integer>","specialties":"<string>"}'
```

### search_brokers_by_name

Search for business brokers by name or company name. Returns matching brokers with full contact details including email, phone, address, bio, and specialty areas. An empty query returns all brokers (same as list_all_brokers).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Name or company name to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibba-org-api-5a2fae5c/search_brokers_by_name \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```