גישה לנתונים — Data API
הדף הזה מתעד את ממשק הנתונים (API) של ״הכסף שלנו״ — הוא כתוב באנגלית ומיועד למחשבים, לסוכני AI ולמפתחים. את אותם נתונים בדיוק אפשר לראות, לחפש ולהבין בדפי האתר:
This page documents the machine-readable JSON API behind Our Money, an independent transparency site about Israeli government spending and actions. If you are a person, the same data is presented readably on the pages linked above (Hebrew, with an English toggle on every page).
Base URL: https://api.ourmoneyil.com
All documented endpoints are GET, return JSON, need no authentication, and send Access-Control-Allow-Origin: *. Text content is Hebrew. Responses are cached (roughly 6 hours; the budget snapshot 12).
Snapshot endpoints (/data/*) wrap their payload in an envelope: {"t": <epoch ms of the snapshot>, "stale": <bool, optional>, "data": …}. If stale is true, the upstream source was unreachable and you are seeing the last good snapshot.
Fair use: this is a small nonprofit relay with shared rate limits — cache what you fetch, keep request volume modest. For bulk research go to the official sources directly (listed at the bottom). Attribution appreciated: הכסף שלנו (ourmoneyil.com).
Stability: the endpoints on this page are the documented, stable surface; changes are announced here. Anything not listed here is internal and may change without notice.
GET /data/budget
The state budget by top-level budget line, all years — allocated, revised and executed net amounts. Refreshed twice a day.
GET /data/votes
Recent Knesset plenum votes.
GET /data/bills
Knesset bills (הצעות חוק).
GET /data/verdicts
Supreme Court decisions from the last 90 days, up to 50 rows. Row fields include Id, CaseId, CaseNum, CaseDesc (e.g. ״עע״מ 38750-12-25״), CaseName (the parties), Type (פסק דין / החלטה), VerdictsDtString (DD/MM/YYYY), Pages, PathForWeb, DocName.
GET /data/persons
Master list of Knesset members.
GET /data/votesmeta
Status of the plenum-vote index behind /search/votes: which years are covered and how many votes each holds, the total row count, and when it last updated. Use it to judge coverage and freshness, not as a data endpoint.
GET /data/billinfo/<id>
One bill's details, by its Knesset BillID.
A database built from the procurement reports the ministries themselves publish; every row lists its source reports.
GET /contracts?code=<budget code>[&year=YYYY][&n=25]
Contracts whose live budget allocation falls under the given budget-code prefix (e.g. code=0020 for the education section), largest volume first. Returns {"code", "year", "rows": […], "more": <bool>}. Row fields: order_id, section, supplier, entity_id (ח״פ), entity_kind, ministry, budget_code, budget_title, volume, paid, currency, first_year, reports[] (the official reports the row was built from, with URLs).
GET /contract?id=<order_id>
One contract in full: all fields, all of its budget allocations (historical ones labelled), and its source reports.
GET /supplier?hp=<company id (ח״פ)>[&n=50]
All contracts of one supplier, with the total count.
GET /search/votes?qs=<query>[&from=YYYY-MM-DD][&to=YYYY-MM-DD][&y0=YYYY][&y1=YYYY][&limit=N]
Free-text search over an index of every Knesset plenum vote from 2003 to today. Within a quoted phrase, words are ANDed (order-free); separate phrases are ORed. Returns {"rows": […], "truncated": <bool>, "keys", "indexRows"}. Row fields: id (Knesset vote id), date, time, src ("m" modern / "a" archive), passed (true / false / null), for, against, abstain, protocol, title (Hebrew).
Outcome caveat: archive rows (src: "a", 2003 – mid‑2021) carry the outcome; modern rows (src: "m") have passed: null and zero counts — the index knows the vote happened, not how it ended. For a modern vote's outcome, look it up by id in the official Knesset API (knesset.gov.il/WebSiteApi/knessetapi/Votes/GetVoteDetails/<id>) or on the votes page, which fills outcomes in.
Example: /search/votes?qs=חינוך&limit=10
GET /preset/votes?from=YYYY-MM-DD&to=YYYY-MM-DD[&type=1]
Plenum vote headers for a date range, straight from the Knesset API. Returns {"Table": [{VoteId, VoteDate, VoteDateStr, VoteTimeStr, VoteType, ItemTitle, KnessetId, SessionId, VoteProtocolNo}]}.
GET /preset/verdicts?from=YYYY-MM-DD&to=YYYY-MM-DD[&q=<text>][&judge=<name>][&lan=1]
Supreme Court verdict search for a date range, optionally filtered by free text or judge name.
GET /preset/reports?sec=<budget section digits>
The published ministry procurement reports for one budget section.
Machine-readable site overview: /llms.txt · full reference in one text file: /llms-full.txt · /sitemap.xml
The data originates from official public sources — for bulk work use them directly: obudget.org (מפתח התקציב) · Knesset OData · data.gov.il
Questions, wrong data, or a use case that needs more than this: [email protected]