# Pacaso — 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 luxury co-ownership properties available through Pacaso and access detailed information including prices per share, locations, square footage, amenities, photos, and property highlights. Search across multiple destinations to find fractional ownership opportunities that match your preferences.

**Category:** Real Estate | **Website:** [www.pacaso.com/](https://www.pacaso.com/) | **Docs:** [parse.bot/marketplace/74194d34-8466-4bc5-809f-96ae31b97e6d/pacaso-com-api](https://parse.bot/marketplace/74194d34-8466-4bc5-809f-96ae31b97e6d/pacaso-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/pacaso/`
**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 listing detail

Get detailed information for a specific property listing by its Pacaso home ID. Optionally provide the destination name to speed up the lookup (avoids searching all destinations). Returns full property details including all photos, amenities, and location data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination` | string | No | Destination/market name to narrow the search (e.g. 'Paris'). Speeds up lookup if known. |
| `home_id` | string | Yes | The pacaso_home_id of the listing (UUID format). Obtainable from get_listings results. |

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

### Get listings

Get property listings with full details. Optionally filter by destination name. Without a destination filter, returns all listings across all active markets (deduped). Each listing includes pricing, location, amenities, photos, and property attributes. The count parameter caps how many listings are fetched per destination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Maximum number of listings to return per destination. |
| `destination` | string | No | Destination/market name to filter by (e.g. 'Paris', 'Lake Tahoe', 'Los Cabos'). Must match a name from list_destinations. If omitted, returns listings across all destinations with discoverable homes. |

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

### List destinations

List all available Pacaso destinations/markets with summary stats including number of discoverable homes, average share price, and top amenities. Returns all markets regardless of whether they currently have discoverable homes.

**Estimated cost:** Metered

_No parameters required._

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

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