---
title: "Data model"
description: "Property and unit information returned by Fairway"
status: "preview"
canonical_url: "https://fairwayrent.ai/docs/agents/data-model"
last_updated: "2026-11-04"
related:
  - "/agents"
  - "/docs/agents/tools"
audience: "agents, developers"
---

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

```json example
{
  "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](/docs/agents/tools).
