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


A breakdown of the total budget into sub-totals. The breakdown is determined by the reporting organisation and described in the narrative. The period covered is the same as that covered by the parent total-budget element. The sum of budget-line values does not have to equal the value given in the parent element.


This element may occur any number of times.



An internal reference for this budget line taken from the reporting organisation’s own system. Optional.

This value must be of type xsd:string.

Example Usage

Example budget-line for total-budget of an iati-organisation.

An example @ref attribute is included.
  <total-budget status="2">
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="USD" value-date="2014-01-01">250000000</value>
   <budget-line ref="1234">
    <value currency="USD" value-date="2014-01-01">200000000</value>
    <narrative>Budget Line</narrative>
The budget-line element can be repeated in any total-budget.



The budget-line element was added as a child element of total-budget.

Developer tools

Find the source of this documentation on github:


Last updated on 2018-02-19