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

> Access data from coldwellbanker.com.mx.

**Category:** Real Estate | **Website:** [coldwellbanker.com.mx/propiedades-busqueda?o=VENTA](https://coldwellbanker.com.mx/propiedades-busqueda?o=VENTA) | **Docs:** [parse.bot/marketplace/9ad731ad-6237-41f1-abb2-5eb4e7525919/coldwellbanker-com-mx-api](https://parse.bot/marketplace/9ad731ad-6237-41f1-abb2-5eb4e7525919/coldwellbanker-com-mx-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/coldwellbanker/`
**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 property detail

Get comprehensive detail for a single property by its ID. Returns full description, all images, pricing with negotiation details, general features, parking, finishes, amenities, condominium details, points of interest, visiting hours, property rules, agent/office contact information, geographic coordinates, listing URL, and operation type. The property_id is obtained from the list_properties endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `property_id` | string | Yes | The numeric property ID from list_properties results (e.g. '65611'). |

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

### List properties

List properties from the Coldwell Banker Mexico database with pagination. Returns property summaries including title, type, address, pricing, dimensions, photos, and office info. Supports filtering by operation type (sale/rent), price range, and location. The total database contains thousands of properties; paginate with page/size to traverse the full set. Each page returns up to 50 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | Filter by municipality/city name (e.g. 'Puerto Vallarta', 'Álvaro Obregón'). |
| `operation` | string | No | Type of operation: VENTA (sale) or RENTA (rent). |
| `page` | integer | No | Zero-based page number for pagination. |
| `price_max` | number | No | Maximum price filter (in the property's listed currency). |
| `price_min` | number | No | Minimum price filter (in the property's listed currency). |
| `property_type_id` | integer | No | Filter by property type ID from the site's catalog. |
| `size` | integer | No | Number of results per page, max 50. |
| `state` | string | No | Filter by state name (e.g. 'Ciudad de México', 'Nuevo León', 'Jalisco'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/coldwellbanker/list-properties \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","operation":"<string>","page":"<integer>","price_max":"<number>","price_min":"<number>","property_type_id":"<integer>","size":"<integer>","state":"<string>"}'
```

## Next steps

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