Linked Listings vs. Past Listings

These two sections both hold arrays of other listings related to the current one — but they represent fundamentally different things and are easy to conflate. This page draws the line clearly.

The core distinction

	`linkedListings`	`pastListings`
What it is	Other active, concurrent listings for the same property, same sale attempt — typically the same listing syndicated or separately entered across multiple MLS boards	Prior, separate listing/sale events at the same address, from an earlier lifecycle that has already ended
Why it exists	Agents cross-list on multiple boards (or a co-listing agent enters a duplicate record) to maximize buyer visibility — "more eyeballs, more boards, more exposure"	The property's sale/listing history — it was listed and/or sold before, under a different (now-closed) listing record
Relationship to the current listing	Same listing period — these are siblings happening right now	A different, earlier listing period — this happened before, and is over
Typical status of the related entries	Active (or otherwise live) — they're up right now, in parallel	Closed / Withdrawn / Expired / Canceled — it's history

Short version: linkedListings = the same listing wearing multiple MLS hats today. pastListings = a different chapter in this address's history.

`linkedListings`

Why this matters

Multi-board markets are common — an agent (or two co-listing agents on different boards) may enter the same property into more than one MLS system to reach a wider buyer pool. When that happens, you'll see the same physical property show up as multiple distinct listing records, each with its own listingId, mlsNumber, and mlsBoardCode, all pointing at each other via linkedListings.

This matters for:

Deduping search results — if you're aggregating across boards, linkedListings tells you two "different" listings you found are actually one property, so you don't double-count inventory.
Cross-board visibility analysis — how many boards is this property being marketed on? A property linked across 3 boards is getting more exposure than one on a single board.
Attribution — listingAgentMlsCode on each linked entry tells you which agent/board entered which copy.

Structure

"linkedListings": [
  {
    "listingId": 10637487968,
    "address": "123 Main St, Austin, TX 78701",
    "mlsNumber": "1234567",
    "mlsBoardCode": "txaustin",
    "listingAgentMlsCode": "3025270",
    "listingDate": "2026-05-01",
    "listingPrice": 425000,
    "photoCount": 24,
    "descriptionLength": 512,
    "numberOfStatusChanges": 0,
    "numberOfPriceChanges": 0,
    "similarityScore": 0.98
  }
]

similarityScore reflects how confident the match is that this linked entry is genuinely the same property (rather than a coincidentally similar one) — useful if you want to threshold out weaker matches.

Filter

Filter	Type	Meaning
`has_linked_listings`	bool	Listing has at least one linked (concurrent, cross-board) entry

There's currently no filter on the contents of linkedListings (e.g. by similarityScore or mlsBoardCode) — only presence. Pull the full array via fields: ["linkedListings"] or field_sections: ["linkedListings"] and inspect it client-side.

Example query

Find properties actively cross-listed on more than one board:

{ "active": true, "has_linked_listings": true }

`pastListings`

Why this matters

A property doesn't start its history with the current listing. pastListings gives you every prior listing/sale record at the same address — a previous time it sold, was withdrawn, or expired, under a listing record that is now closed and unrelated to the current one. This is a completely separate lifecycle from statusChangeHistory (which tracks status transitions within the current listing) — pastListings is about earlier, distinct listings.

This matters for:

Sale history / market timing — how many times has this address changed hands or been listed? A property that's been listed 4 times in 3 years is a different story than one listed once and sold.
Pricing context — listPriceAtClose on a past listing tells you what it actually sold for last time, a real anchor for current pricing analysis.
Agent track record — listingAgentName/sellingAgentName and daysOnMarketAtClose on past listings can inform how quickly a given agent has historically moved this property (or similar ones).
Distinguishing "genuinely new to market" from "recycled listing" — a property with no pastListings is likely a first-time sale; one with several is a repeat player in this market.

Structure

"pastListings": [
  {
    "listingId": 9876543210,
    "address": "123 Main St, Austin, TX 78701",
    "mlsNumber": "0987654",
    "mlsBoardCode": "txaustin",
    "listingDate": "2022-03-10",
    "listPriceAtClose": 380000,
    "daysOnMarketAtClose": 45,
    "listingOutcome": "Closed",
    "listingOutcomeDate": "2022-04-24",
    "listingAgentMlsCode": "3025270",
    "listingAgentName": "William B Prendergast",
    "sellingAgentMlsCode": "1194832",
    "sellingAgentName": "Jane Doe",
    "modificationTimestamp": "2022-04-25T10:00:00Z",
    "similarityScore": 0.95
  }
]

Note the outcome-oriented fields here (listingOutcome, listingOutcomeDate, listPriceAtClose, daysOnMarketAtClose) that don't exist on linkedListings — because pastListings entries represent completed listing events with a known result, while linkedListings entries represent currently live siblings with no outcome yet.

Filter

Filter	Type	Meaning
`has_past_listings`	bool	This address has at least one prior, separate listing record

Same limitation as linkedListings — presence-only filtering today. Pull the full array via fields: ["pastListings"] or field_sections: ["pastListings"] for the detail.

Example query

Find active listings on properties that have sold or been listed before (repeat-market properties):

{ "active": true, "has_past_listings": true }

Find brand-new-to-market properties (no listing history at this address):

{ "active": true, "has_past_listings": false }

Quick disambiguation checklist

Ask yourself: "Is this about the same sale attempt happening on another board right now, or a different sale attempt that already happened?"

Same sale attempt, right now, different board/agent copy → linkedListings
Different, earlier sale attempt at this address, already concluded → pastListings