{
  "schema_version": "property-profile-field-catalog-v2",
  "applies_to": "property-profile-v2",
  "fields": [
    {
      "path": "availability.status",
      "semantics": "Current property availability: active when a current marketplace listing is matched, otherwise off_market for an accepted parcel. Unknown is reserved for unresolved property identity.",
      "provenance": "Accepted parcel identity plus matched current marketplace listings"
    },
    {
      "path": "availability.active_deal_types[]",
      "semantics": "Buy or Rent types represented by current matched source listings; empty unless availability is active.",
      "provenance": "Current portal advertisements"
    },
    {
      "path": "sources[].listings[]",
      "semantics": "Complete marketplace advertisements grouped by source. Multiple advertisements from one source remain distinct and public-record parcels never appear as listings.",
      "provenance": "Source listing identity and detail enrichment"
    },
    {
      "path": "sources[].listings[].pricing",
      "semantics": "Advertisement-specific asking price, range, previous price, discount, fees, display text, and price quality. It is not a valuation.",
      "provenance": "Source advertisement"
    },
    {
      "path": "sources[].listings[].unit",
      "semantics": "Unit or advertisement-specific physical facts. Canonical parcel facts stay under property and are not copied into unrelated summary fields.",
      "provenance": "Source advertisement"
    },
    {
      "path": "sources[].listings[].advertiser",
      "semantics": "Agency, agent, developer, and observed contact details attached to this exact advertisement.",
      "provenance": "Source advertisement"
    },
    {
      "path": "history.listing_events[]",
      "semantics": "Observed portal listing, status, and price events; not title evidence.",
      "provenance": "Source advertisement history"
    },
    {
      "path": "history.recorded_transfers[]",
      "semantics": "Official recorded-transfer evidence; not a complete ownership chain or inferred sale.",
      "provenance": "Public record source"
    },
    {
      "path": "history.ownership_events[]",
      "semantics": "Source-attributed ownership observations. Public profiles retain references and limitations without exposing internal owner names.",
      "provenance": "Public record source"
    },
    {
      "path": "history.assessments[]",
      "semantics": "Official assessment observations kept separate from estimates.",
      "provenance": "Assessment roll"
    },
    {
      "path": "history.tax_events[]",
      "semantics": "Attributed property-tax payment or charge observations kept separate from assessments and valuations.",
      "provenance": "Public record or listing-history source"
    },
    {
      "path": "history.valuations[]",
      "semantics": "Source-provided estimated values; not CleanedWeb appraisals.",
      "provenance": "Listing or explicit valuation source"
    },
    {
      "path": "context.area_profile_ref",
      "semantics": "Immutable reference to a Places release. ZIP and ZCTA identities are never treated as interchangeable without an assignment method.",
      "provenance": "Versioned geography assignment"
    },
    {
      "path": "provenance.fact_sources",
      "semantics": "Field-path to evidence-reference mapping for canonical physical facts.",
      "provenance": "Canonicalization evidence"
    },
    {
      "path": "media",
      "semantics": "Not exposed by property-profile-v2. Source media assets remain internal and may be retained only under the applicable source and rights policy.",
      "provenance": "Internal source storage"
    }
  ]
}