This is the reference page for the XML element forecast.


A container to hold separate forecasts for each of the years specified Text() holds the forecast value for each year.


The text in this element must be of type xsd:decimal.

This element may occur any number of times.



The calendar year that the forward spend covers

This attribute is required.

This value must be of type xsd:decimal.


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 value must be of type xsd:date.

Example Usage

Example of forecast for the fss of 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 the attribute @year as 2014.
This example declares a Currency code GBP, using the @currency attribute.
Note: A Currency code should only be declared if different to @default-currency in the iati-activity element.
  <fss extraction-date="2014-05-06" priority="1" phaseout-year="2016">
   <forecast year="2014" value-date="2013-07-03" currency="GBP">10000</forecast>
Note: multiple forecasts are expressed by repeating the forecast element.



New in 1.03
Added the optional fss element and its child elements

Developer tools

Find the source of this documentation on github: