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


The amount of the contribution.


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 a transaction in 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.
  <transaction ref="1234" humanitarian="1">
   <transaction-type code="1" />
   <transaction-date iso-date="2012-01-01" />
   <value currency="EUR" value-date="2012-01-01">1000</value>   
    <narrative>Transaction description text</narrative>
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" type="10" ref="BB-BBB-123456789">
    <narrative>Agency B</narrative>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" type="23" ref="AA-AAA-123456789">
    <narrative>Agency A</narrative>
   <disbursement-channel code="1" />
   <sector vocabulary="2" code="111" />
   <!--Note: only a recipient-region OR a recipient-country is expected-->
   <recipient-country code="TM" />
   <recipient-region code="616" vocabulary="1" />   
   <flow-type code="10" />
   <finance-type code="110" />
   <aid-type code="A01" />   
   <tied-status code="3" />



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 2016-09-08