This is the reference page for the XML element total-budget. See also the relevant overview page: Budgets


The total-budget element allows for the reporting of the organisation’s own budget. The recommendation is that, where and when possible, the organisation’s total annual planned budget for each of the next three years is reported.

Example Usage

Example of total-budget for a single iati-organisation.
Periods are stated using period-start and period-end, with dates in ISO 8601 format (YYYY-MM-DD).
This example total-budget is reported for years 2014, *2015 and 2016.
The value example includes a currency of USD - which differs from that set as default-currency in iati-organisation.
The value-date is reported in ISO 8601 format (YYYY-MM-DD).
Note: multiple budgets are expressed by repeating the total-budget element.
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="USD" value-date="2014-01-01">250000000</value>
   <period-start iso-date="2015-01-01" />
   <period-end iso-date="2015-12-31" />
   <value currency="USD" value-date="2014-01-01">300000000</value>
   <period-start iso-date="2016-01-01" />
   <period-end iso-date="2016-12-31" />
   <value currency="USD" value-date="2014-01-01">350000000</value>

Developer tools

Find the source of this documentation on github: