This is the reference page for the XML element iati-activity.


Top-level element for a single IATI activity report.

The schema states that this element must have at least 1 subelement.



A number indicating the IATI specification version in use. “1.01” should be assumed if not specified. It is required to specify this attribute if the document is using features specific to an IATI specification other than the initial 1.01 version.

This value must be of type xsd:decimal.


The last date/time that the data for this specific activity was updated. This date must change whenever the value of any field changes.

This value must be of type xsd:dateTime.


ISO 2 letter code specifying the language of text in this element.

This value must be on the Language codelist.


Default ISO 4217 currency code for all financial values in this activity report. See http://iatistandard.org/codelists/currency

This value must be of type xsd:string.

This value must be on the Currency codelist.


The hierarchical level within the reporting organisation’s subdivision of its units of aid. (eg activity = 1; sub-activity = 2; sub-sub-activity = 3). If hierarchy is not reported then 1 is assumed. If multiple levels are reported then, to avoid double counting, financial transactions should only be reported at the lowest hierarchical level.

This value must be of type xsd:int.


A Linked Data URI for a given activity (overrides iati-activities/@linked-data-default if set)

This value must be of type xsd:string.

Example Usage

Example of iati-activity with last updated-datetime of on 2nd September 2014.

Language set as en (English) and a default-currency to EUR (Euros).

An optional attribute of hierarchy is set as 1

An optional version of 1.05 is also stated.

The optional attribute linked-data-uri (introduced in the decimal upgrade 1.02) is also included:

 <iati-activity xml:lang="en" default-currency="EUR" last-updated-datetime="2014-09-02T16:15:37" hierarchy="1" version="1.05" linked-data-uri="http://data.example.org/123456789">

The iati-activity element acts as a container for other sub-elements. It is closed as follows:




Introduced the linked-data-uri attribute on iati-activity element


See previous version on the IATI Standard wiki and website

Developer tools

Find the source of this documentation on github: