For AI agents: This page describes the Fairway preview. The MCP endpoint is coming soon.
Data model
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#
| Field | Type | Meaning |
|---|---|---|
id | string | Listing identity; pass it to lookup or get. |
status | string | Current observed listing status. |
property | object | Name, address, and coordinates when known. |
units | array | Units belonging to the property, when detail is known. |
rent_min, rent_max, units[].rent | integer or null | USD cents. Unknown values are omitted or null. |
checked_at | ISO timestamp | When Fairway last checked this evidence. |
listing_url, share_url | URL | Send renters back to the actual listing. |
fees | object | Known costs; missing fee fields are unknown, not free. |
Example#
Illustrative only. The endpoint is coming soon.
{
"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.