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


The value of the activity’s budget for each financial quarter or year over the lifetime of the activity. The purpose of this element is to provide predictability for recipient planning on an annual basis. The status explains whether the budget being reported is indicative or has been formally committed. The value should appear within the BudgetStatus codelist. If the @status attribute is not present, the budget is assumed to be indicative. The sum of budgets may or may not match the sum of commitments, depending on a publisher’s business model and legal frameworks.


This element may occur any number of times.



Whether this is the original budget (prepared when the original commitment was made) or has subsequently been revised

This value must be of type xsd:string.

This value must be on the BudgetType codelist.

Example Usage

Example budget for an iati-activity.

This element is a parent for other child elements.
The @type attribute declares a valid code (1) from the BudgetType codelist.
<budget type="1">
Note: If omitted, then BudgetType code 1 (Original) is assumed.
Full example with all child elements:
  <budget type="1">
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="EUR" value-date="2014-01-01">3000</value>
The budget element can be repeated in any iati-activity.

Developer tools

Find the source of this documentation on github: