{
  "change_policy": "Fields are never removed or renamed without at least 3 months notice in the changelog (/api/v1/changelog.json): the old name keeps working next to the new one until the removal date given there. New fields, files and records can be added at any time, so ignore fields you do not know.",
  "deprecations": [
    {
      "file": "places.json",
      "field": "ses",
      "replaced_by": "ses_summary",
      "deprecated_on": "2026-10-11",
      "removal_not_before": "2027-01-31",
      "why": "The full record has a different `ses` block (the count of the unit's areas); `ses_summary` is the same name in both files."
    }
  ],
  "entries": [
    {
      "date": "2026-11-04",
      "version": "1.4.0",
      "changes": [
        {
          "kind": "removed",
          "en": "The records of the neighborhoods with fewer than 200 residents or no figure: no file under places/, no row in places.json, nothing in the bulk files. Their pages on the website stay.",
          "he": "הסרנו את הרשומות של שכונות שגרים בהן פחות מ-200 תושבים, או שאין עליהן נתון: אין להן קובץ, שורה ב-places.json או שורה בהורדה המרוכזת. הדפים שלהן באתר נשארים."
        }
      ]
    },
    {
      "date": "2026-10-13",
      "version": "1.3.0",
      "changes": [
        {
          "kind": "added",
          "en": "`description` and `description_en` in the full record of a locality or a neighborhood that has one: a short text about the place written from open sources (`description` is {text_he, sources, as_of}; `description_en` is the English text of it). Absent when the place has none.",
          "he": "השדות description ו-description_en ברשומה המלאה של יישוב או שכונה שיש להם תיאור: טקסט קצר על המקום, שנכתב ממקורות פתוחים (description הוא {text_he, sources, as_of}, ו-description_en הוא הטקסט באנגלית). השדות חסרים כשאין תיאור למקום."
        }
      ]
    },
    {
      "date": "2026-10-12",
      "version": "1.2.0",
      "changes": [
        {
          "kind": "added",
          "en": "`elections.change` in the full record of a locality or a neighborhood: each bloc's and group's change in share since the previous election (Knesset 25 against 24 in this export; 26 against 25 once Knesset 26 is in), with a status and the valid votes behind it.",
          "he": "השדה elections.change ברשומה המלאה של יישוב ושל שכונה: השינוי בחלק של כל גוש וקבוצה מאז הבחירות הקודמות, עם מצב ומספר הקולות הכשרים שמאחוריו."
        }
      ]
    },
    {
      "date": "2026-10-11",
      "version": "1.1.0",
      "changes": [
        {
          "kind": "added",
          "en": "Bulk downloads: /api/v1/bulk/places.ndjson.gz (every full record, one per line, gzip) and /api/v1/bulk/places-core.csv (core figures, one row per place, each with its year).",
          "he": "הורדה מרוכזת: places.ndjson.gz (כל הרשומות המלאות, אחת בכל שורה, דחוס) ו-places-core.csv (הנתונים העיקריים, שורה לכל מקום, עם השנה של כל נתון)."
        },
        {
          "kind": "added",
          "en": "`ses_summary` in places.json, the same object as `ses_summary` in the full record.",
          "he": "השדה ses_summary ב-places.json, אותו אובייקט כמו ses_summary ברשומה המלאה."
        },
        {
          "kind": "deprecated",
          "en": "`ses` in places.json: use `ses_summary`. `ses` stays until at least 2027-01-31.",
          "he": "השדה ses ב-places.json: להשתמש ב-ses_summary. השדה ses יישאר לפחות עד 31.1.2027."
        },
        {
          "kind": "changed",
          "en": "JSON files are served as application/json; charset=utf-8 and the CSV as text/csv; charset=utf-8.",
          "he": "קובצי JSON מוגשים כ-application/json; charset=utf-8, וקובץ ה-CSV כ-text/csv; charset=utf-8."
        },
        {
          "kind": "added",
          "en": "changelog.json, the change policy and the deprecations in meta.json.",
          "he": "יומן שינויים (changelog.json), מדיניות שינויים ורשימת שדות שיוצאים משימוש ב-meta.json."
        }
      ]
    }
  ]
}