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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pacaso-com-api-74194d34/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-pacaso-com-api-74194d34/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pacaso-com-api-74194d34/get_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-pacaso-com-api-74194d34/list_destinations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```