{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "$id": "https://israelistay.com/data/schema.json",
 "title": "StayIsrael feed record (stayisrael.feed/1)",
 "description": "One item of properties[] in /data/properties.json, /data/city/<code>.json and /data/type/<category>.json. Built from the records in this build (registry 2026-11-15T01:40:11+00:00). Optional fields appear only when the official source has the value; nothing is estimated. There are no price, rating or availability fields.",
 "type": "object",
 "required": [
  "address_he",
  "category",
  "category_he",
  "id",
  "locality_code",
  "locality_he",
  "name_he",
  "page_url",
  "source",
  "subdistrict_he",
  "type_source"
 ],
 "additionalProperties": false,
 "properties": {
  "address_he": {
   "type": "string",
   "description": "Address as in the source record; when official_address_note is present, the address from the place's own site (address_source_url) and the official value is in the note (owner decision 1.11.2026)."
  },
  "address_source_url": {
   "type": "string",
   "description": "Page on the place's own site that shows the displayed address."
  },
  "address_source_withheld_he": {
   "type": "string",
   "description": "Present instead of address_source_url when that page is a hotel-chain page that also sells rooms (D28)."
  },
  "area_he": {
   "type": "string",
   "description": "Area within the city, as in the official source record, when the source has one."
  },
  "category": {
   "type": "string",
   "description": "StayIsrael category key, from the source type field, or from the place's own official site (see category_source). Never from the name.",
   "enum": [
    "hotel",
    "boutique",
    "aparthotel",
    "hostel",
    "capsule",
    "guesthouse",
    "hourly",
    "apartment",
    "chalet",
    "field_school",
    "campsite_paid"
   ]
  },
  "category_he": {
   "type": "string",
   "description": "Hebrew label of category. \"hourly\" is labelled \"מלון לפי שעה\" (decision D17)."
  },
  "category_source": {
   "type": "object",
   "description": "Present only when the category comes from the place's own official site: kind, url, checked_at, evidence_he.",
   "properties": {
    "checked_at": {
     "type": "string"
    },
    "evidence_he": {
     "type": "string"
    },
    "kind": {
     "type": "string"
    },
    "url": {
     "type": "string"
    }
   },
   "required": [
    "checked_at",
    "evidence_he",
    "kind",
    "url"
   ]
  },
  "chain_he": {
   "type": "string",
   "description": "Chain field of the official source record."
  },
  "coord_origin": {
   "type": "string",
   "description": "\"source\" when the coordinates come from the official source record."
  },
  "decision": {
   "type": "string",
   "description": "\"D37\" for places added from the national lodging dataset after a second-source check (decision log docs/DECISIONS_he.md)."
  },
  "id": {
   "type": "string",
   "description": "Stable StayIsrael id: <source prefix>-<record ref in the source>."
  },
  "iha_member": {
   "type": "boolean",
   "description": "true when the official source record marks the place as an Israel Hotel Association member; absent otherwise."
  },
  "independent": {
   "type": "boolean",
   "description": "true only when the chain field of the official source record says \"עצמאי\"; absent otherwise (absent does not mean chain)."
  },
  "lat": {
   "type": "number",
   "description": "Latitude (WGS84, 6 decimals), only when the official source record has coordinates."
  },
  "licence_numbers": {
   "type": "array",
   "description": "Business licence numbers in the municipal licensing record.",
   "items": {
    "type": "integer"
   }
  },
  "licence_status_he": {
   "type": "string",
   "description": "Licence status as in the municipal licensing record."
  },
  "licence_valid_until": {
   "type": "string",
   "description": "Licence expiry date as in the municipal licensing record (YYYY-MM-DD)."
  },
  "locality_code": {
   "type": "string",
   "description": "CBS (הלמ\"ס) locality code."
  },
  "locality_he": {
   "type": "string",
   "description": "Locality name (CBS list)."
  },
  "lon": {
   "type": "number",
   "description": "Longitude (WGS84, 6 decimals), only when the official source record has coordinates."
  },
  "name_en": {
   "type": "string",
   "description": "English name, only when the official source record has one."
  },
  "name_he": {
   "type": "string",
   "description": "Name as written in the source record; when name_history is present, the current name from the place's own site (name_source_url), owner decision 1.11.2026."
  },
  "name_history": {
   "type": "array",
   "description": "Earlier names of the same place (the official record may still carry the earlier name).",
   "items": {
    "type": "string"
   }
  },
  "name_source_url": {
   "type": "string",
   "description": "Page on the place's own site that shows the current name."
  },
  "name_source_withheld_he": {
   "type": "string",
   "description": "Present instead of name_source_url when that page is a hotel-chain page that also sells rooms (D28)."
  },
  "official_address_note": {
   "type": "string",
   "description": "The address as written in the official list, when the displayed address comes from the place's own site."
  },
  "official_copy": {
   "type": "object",
   "description": "Descriptive text copied from the place's own official website (D6 expansion Moshe 5.11.2026 16:40): summary/about/rooms/area when found. Price lists and prices are stripped. Absent when none found.",
   "properties": {
    "about": {
     "type": "string"
    },
    "area": {
     "type": "string"
    },
    "fetched_at": {
     "type": "string"
    },
    "lang": {
     "type": "string"
    },
    "rooms": {
     "type": "string"
    },
    "source_page_url": {
     "type": "string"
    },
    "summary": {
     "type": "string"
    }
   },
   "required": [
    "fetched_at",
    "lang"
   ]
  },
  "official_photo": {
   "type": "object",
   "description": "Photo(s) copied from the place's own official website (decision D6, Moshe 5.11.2026 16:26; many photos per place from 16:30). url is the primary image; photos[] is the gallery; each item has source_page_url (omitted for booking-chain pages, D37); raw source image URLs are kept in the API, not in these feeds. Absent when none could be collected; UI then keeps the placeholder.",
   "properties": {
    "count": {
     "type": "integer"
    },
    "fetched_at": {
     "type": "string"
    },
    "photos": {
     "type": "array"
    },
    "room_photo_count": {
     "type": "integer"
    },
    "source_page_url": {
     "type": "string"
    },
    "url": {
     "type": "string"
    }
   },
   "required": [
    "count",
    "fetched_at",
    "photos",
    "room_photo_count",
    "url"
   ]
  },
  "official_site": {
   "type": "object",
   "description": "Official website of the place (kind \"own\") or of its operator (kind \"operator\"), present only when the national lodging dataset marks the URL as verified (page fetched, name and street matched the official record, second check). Not an affiliate link. Same list as web-app/official_sites.js (decisions D30, D35).",
   "properties": {
    "kind": {
     "type": "string"
    },
    "label_he": {
     "type": "string"
    },
    "url": {
     "type": "string"
    }
   },
   "required": [
    "kind",
    "label_he",
    "url"
   ]
  },
  "ownership_chain_he": {
   "type": "string",
   "description": "Chain membership found on the chain's own site (see ownership_evidence_url)."
  },
  "ownership_class": {
   "type": "string",
   "description": "Set only when chain membership was verified on the chain's own site."
  },
  "ownership_evidence_url": {
   "type": "string",
   "description": "Chain-site page that lists the place."
  },
  "ownership_evidence_withheld_he": {
   "type": "string",
   "description": "Present instead of ownership_evidence_url when that page is a hotel-chain page that also sells rooms (D28)."
  },
  "ownership_note": {
   "type": "string",
   "description": "How the chain membership was matched."
  },
  "page_url": {
   "type": "string",
   "description": "Pre-rendered StayIsrael page for this place."
  },
  "rooms": {
   "type": [
    "integer",
    "string"
   ],
   "description": "Number of rooms as in the official source record, when the source has one."
  },
  "second_source_checked_at": {
   "type": "string",
   "description": "When the second source was checked."
  },
  "second_source_type_he": {
   "type": "string",
   "description": "Kind of the second source, in Hebrew (for example \"האתר של המקום\")."
  },
  "second_source_url": {
   "type": "string",
   "description": "Link to the second source that confirmed the place (usually the place's own website). Not an affiliate link."
  },
  "second_source_withheld_he": {
   "type": "string",
   "description": "Present instead of second_source_url when the second source is a hotel-chain page that also sells rooms (no booking links, D28)."
  },
  "source": {
   "type": "object",
   "description": "Provenance: id (source id), record_ref (record in the source), url (the official record), source_date, fetched_at (when we checked it).",
   "properties": {
    "fetched_at": {
     "type": "string"
    },
    "id": {
     "type": "string"
    },
    "record_ref": {
     "type": "string"
    },
    "source_date": {
     "type": "string"
    },
    "url": {
     "type": "string"
    }
   },
   "required": [
    "fetched_at",
    "id",
    "record_ref",
    "source_date",
    "url"
   ]
  },
  "source_url": {
   "type": "string",
   "description": "Link to the record in the first source (same record as source.url)."
  },
  "status_he": {
   "type": "string",
   "description": "Status field of the official source record, when the source has one."
  },
  "subdistrict_he": {
   "type": "string",
   "description": "CBS subdistrict (נפה) of the locality."
  },
  "type_source": {
   "type": "string",
   "description": "Type value exactly as written in the official source record."
  },
  "verified_second_source": {
   "type": "boolean",
   "description": "true when the national lodging dataset confirmed the place in a second, independent source (D37). Shown as the badge \"אומת במקור שני\"."
  },
  "waze_url": {
   "type": "string",
   "description": "Waze navigation link built from lat/lon; present only when lat/lon are present."
  }
 }
}
