הכסף שלנו

גישה לנתונים — 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).

General

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.

Snapshots — /data/*

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.

Government contracts — /contracts, /contract, /supplier

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.

Vote search — /search/votes

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

Presets — canned queries against official sources

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.

Sources & more for machines

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]