AGENT DOCUMENTATION

For AI agents: This page describes the Fairway preview. The MCP endpoint is coming soon.

Data model

.md

The preview contract describes a property with one or more units. A listing is the agent-facing record to search, refresh, and link back to Fairway.

search_listings starts with the renter's housing request in query. Its response includes applied_filters and not_applied before the listing records, so agents can see which criteria Fairway used and rank the remainder themselves.

Hierarchy#

property → units. This resembles a catalog product with variants, but this is a Fairway preview contract, not a UCP certification.

Core fields#

FieldTypeMeaning
idstringListing identity; pass it to lookup or get.
statusstringCurrent observed listing status.
propertyobjectName, address, and coordinates when known.
unitsarrayUnits belonging to the property, when detail is known.
rent_min, rent_max, units[].rentinteger or nullUSD cents. Unknown values are omitted or null.
checked_atISO timestampWhen Fairway last checked this evidence.
listing_url, share_urlURLSend renters back to the actual listing.
feesobjectKnown costs; missing fee fields are unknown, not free.

Example#

Illustrative only. The endpoint is coming soon.

json
{
  "id": "example-listing",
  "status": "available",
  "property": {"name": "Example property", "address": "Example address"},
  "units": [{"id": "example-unit", "rent": 350000, "beds": 1, "baths": 1}],
  "checked_at": "2026-10-30T00:00:00Z",
  "listing_url": "https://fairwayrent.ai/property/ca/menlo-park/example",
  "share_url": "https://fairwayrent.ai/property/ca/menlo-park/example"
}

Interpretation#

Treat any AI-inferred field as a signal, not landlord-authored text. Check freshness and follow the listing link before stating availability as fact. The complete preview shapes are on each tool page.