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


Data type for an element containing a currency value.


This element must occur once and only once (within each parent element).



The ISO 4217 alphabetic currency code of the value reported. This is required unless the iati-activity/@default-currency is present and applies.

This value must be of type xsd:string.

This value must be on the Currency codelist.


The date to be used for determining the exchange rate for currency conversions.

This value must be of type xsd:date.

Example Usage

Example usage of value of budget for an iati-activity.

An example date is declared in the @value-date attribute.
This example date format conform to the xsd:date standard - for most cases YYYY-MM-DD is sufficient.
This example declares a Currency code EUR, using the @currency attribute.
Note: A Currency code should only be declared if different to @default-currency in the iati-activity element.
  <budget type="1" status="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>



Values are now allowed to be declared as decimals instead of integers.

Developer tools

Find the source of this documentation on github:

Last updated on 2018-02-19