# data.json: what it holds

The file the map runs on (CC BY 4.0, credit War Balance). Amounts are € bn unless a key says otherwise; yearly series run from 2021 (index 0, the year before the war) to 2026; + is toward Ukraine. detail.json holds the data-coverage notes and the method band's rebuilt alternatives. The pipeline's own notes on each field: docs/reference/pipeline.md in the repository.

## Top level

| Key | What it holds |
| --- | --- |
| generated | the date the file was built |
| data_to | the data's last month (YYYY-MM-DD) |
| years | the years of every series: 2021 (the year before the war, the comparison year) to 2026 |
| frac | the share of each year the data cover (2026: January to August) |
| meta | constants of the model (tariff rate, the fallback margin, the common refugee cost per person-year) |
| status_html | the map's status line |
| sources | every source by id: name, url, date, type (data, report, press, ours, notes) and its documents (links, with key documents marked) |
| countries | every country and territory by ISO 3166 alpha-3 code (below) |
| included_in | territories counted in another country's figures (code: the code of the country that holds them) |

## countries.<ISO3> (232 entries)

| Key | Type | Entries with it | What it holds |
| --- | --- | --- | --- |
| aid | object | 232 | aid to Ukraine: Kiel figures by year and category, the EU share, loans and their gift value, weapons at market value, aid not yet delivered, refugee costs and the host's gain on refugees' work |
| buy_ukr | object | 232 | purchases from Ukraine |
| chpl | object | 63 | goods Russia's weapons need (a marker) |
| company | object | 132 | taxes its companies pay in Russia |
| dual_use_note | number | 1 | dual-use goods inside its exports to Russia (already counted) |
| energy | object | 231 | the extra paid to replace Russian energy and the discount on Russian oil (outside the totals) |
| eu_share | number | 27 | see docs/reference/pipeline.md |
| extra | array | 99 | parts without a series of their own (company profits in Russia, the sanctions premium, Russian-owned firms, arms bought from Russia, state projects, IMF/World Bank share, frozen money, Russian forces, payment agents) |
| flowback | object | 51 | money flowing back from the war effort (aid spent at home, others' aid spent here, arms Ukraine bought here) |
| from_rus | object | 232 | sales to Russia: yearly values, ranges and baseline |
| gdp | number | 229 | one year's GDP, € bn (2022–2024 average) |
| gdp_2024 | number | 199 | GDP in 2024, € bn (a method-band alternative) |
| hidden | object | 10 | gold and hidden payments to Russia |
| hub | string | 21 | a trade hub's note (re-exports, fuel trading, gold) |
| iso3 | string | 232 | ISO 3166 alpha-3 code |
| kind | string | 232 | country or territory |
| laund | object | 217 | fuel made from Russian crude bought via other countries |
| military_rus | object | 4 | weapons and troops sent to Russia, and the share Russia paid for |
| n | string | 232 | the shape's id in countries-50m.json |
| name | string | 232 | English name in the data (the site writes some differently: Türkiye, Vatican City) |
| ng_own | boolean | 231 | the country's own net gain on its sales |
| no_data | array | 74 | parts with no observation of the country's own for the war years |
| ownGain | object | 229 | the country's own gain from trade with Russia, the second line, in the same form |
| party_to_war | object | 2 | why it is a party to the war, with sources |
| people | object | 76 | people: refugees from Ukraine hosted (count and date) |
| pipeline_exempt | object | 2 | the EU pipeline-oil exemption it used (a label) |
| pop | number | 229 | population, millions |
| private | object | 172 | private donations to Ukraine |
| ref_excluded | object | 1 | refugees hosted by a party to the war (not counted) |
| remit | object | 9 | migrants' money sent home from Russia (a marker) |
| rusGain | object | 229 | Russia's own gain, the first line of the trade number, by year (years) and cumulative with its range (cum: [middle, low, high] to each year), € bn, + toward Ukraine |
| rusforces | object | 7 | years Russian forces (Wagner, Africa Corps) operated here |
| sanctions | object | 42 | how much of the cut in trade sanctions required, by flow |
| sell_ukr | object | 232 | sales to Ukraine |
| shipping | object | 45 | shipping and insuring Russian oil |
| svc_bought | object | 198 | services bought from Russia |
| svc_sold | object | 198 | services sold to Russia |
| svc_ukr | object | 100 | extra services sold to Ukraine |
| taken | array | 43 | what Russia took from the country's companies (outside the totals) |
| tariff_waiver | boolean | 29 | import tariffs dropped for Ukraine |
| to_rus | object | 232 | purchases from Russia: yearly values (€ bn, years[0] = 2021), ranges, the no-war baseline and price indices, Russia's gain shares and the laundered-oil inputs |
| undisclosed | object | 6 | undisclosed military aid (estimate) |
| vk | object | 231 | the share of money earned that is kept in the economy and genuinely extra, by kind of earning |
| windfall | object | 232 | the war-time fuel price premium paid to Russia |