This is the reference page for the XML element value.


The total value of the organisation’s aid expenditure for this period.


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



A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-organisation/@default-currency attribute is specified.

This value must be of type xsd:string.


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

This attribute is required.

This value must be of type xsd:date.

Example Usage

Example value of total-expenditure for an iati-organisation.

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 USD, using the @currency attribute.
Note: A Currency code should only be declared if different to @default-currency in the iati-organisation 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>
   <expense-line ref="1234">
     <value currency="USD" value-date="2014-01-01">200000000</value>
     <narrative xml:lang="en">Expense Line</narrative>



The optional total-expenditure element was added.

Developer tools

Find the source of this documentation on github: