# Yachtauctions — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Browse and search National Liquidators' inventory of boats, yachts, and other vessels available for auction, with access to detailed listings, live auctions, featured items, and recently listed vessels. Filter by vessel makes and types to find your next acquisition.

**Category:** Marketplaces | **Website:** [yachtauctions.com/](https://yachtauctions.com/) | **Docs:** [parse.bot/marketplace/6de8dd22-e61f-46b1-af57-b616a447d43c/yachtauctions-com-api](https://parse.bot/marketplace/6de8dd22-e61f-46b1-af57-b616a447d43c/yachtauctions-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get vessel detail

Get detailed information for a specific vessel by its slug. Returns title, asking price, contact info, specifications, description, and photos. Returns input_not_found if the vessel no longer exists or has been removed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Vessel listing slug from list_vessel_listings or search_vessels results (e.g. '2019-sea-ray-slx-230-stk-41740'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/get-vessel-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get vessel makes

Get the list of available vessel makes for use as filter values in list_vessel_listings. Each make includes a slug, display name, and listing count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/get-vessel-makes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get vessel types

Get the list of available vessel types for use as filter values in list_vessel_listings. Each type includes a slug, display name, and listing count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/get-vessel-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List featured listings

List featured vessel listings, sorted by featured status. Returns up to 18 items. These are premium listings highlighted by the platform.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/list-featured-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List live auctions

List currently active live auction vessel listings. Count varies based on active auctions. Returns only vessels with active bidding.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/list-live-auctions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List recently listed

List the most recently added vessel listings, sorted by date descending. Returns up to 18 items.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/list-recently-listed \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List vessel listings

List vessel listings with pagination and filters. Returns up to 18 items per page. Supports filtering by make, vessel type, live auction status, text search, and sorting. Paginates via zero-based page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `live_auctions` | boolean | No | Set to true to show only live auction listings. Omission shows all listings. |
| `make` | string | No | Filter by vessel make slug from get_vessel_makes (e.g. 'sea-ray', 'bayliner'). |
| `page` | integer | No | Zero-based page number. Each page returns up to 18 items. |
| `query` | string | No | Free-text keyword to search vessel titles and descriptions. |
| `sort_by` | string | No | Sort option slug. |
| `vessel_type` | string | No | Filter by vessel type slug from get_vessel_types (e.g. 'center-console', 'cruiser'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/list-vessel-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"live_auctions":"<boolean>","make":"<string>","page":"<integer>","query":"<string>","sort_by":"<string>","vessel_type":"<string>"}'
```

### Search vessels

Search for vessels by keyword. Matches against vessel titles and descriptions. Returns all matching results in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword matching vessel titles and descriptions (e.g. 'Sea Ray', 'Sundancer', 'Fountain'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yachtauctions/search-vessels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.