This is the reference page for the XML element value.


The budget sub-total. The definition of the sub-division is determined by iati-organisation/recipient-org-budget/budget-line/narrative


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.

This value must be on the Currency codelist.


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 usage of value in context of budget-line element.

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.
  <recipient-org-budget status="2">
   <recipient-org ref="AA-ABC-1234567">
    <narrative>Org Name</narrative>
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="USD" value-date="2014-01-01">2500000</value>
   <budget-line ref="1234">
    <value currency="USD" value-date="2014-01-01">2000000</value>
     <narrative>Budget Line</narrative>



The budget-line element was introduced in 2.01.

Developer tools

Find the source of this documentation on github: