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


Top-level element for a single IATI activity report.


This element must occur at least once (within each parent element).



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 639-1 code specifying the default language used in narrative elements throughout the activity. If this is not declared then the xml:lang attribute MUST be specified for each narrative element.

This value should be on the Language codelist.


Default ISO 4217 alphabetic currency code for all financial values in this activity report. If this is not declared then the currency attribute MUST be specified for all monetary values.

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:anyURI.

Example Usage

Example of iati-activity.

This element is a parent for other child elements.
This example provides a dateTime of 2014-09-10T07:15:37Z for the @last-updated-datetime attribute.
A dateTime in UTC time is indicated by adding a Z behind the time
This example date time format conforms to the xsd:dateTime standard.
The @xml:lang attribute declares a valid code (en) from the Language codelist.
The @default-currency attribute declares a valid code (USD) from the Currency codelist.
The optional @hierarchy attribute of is set as 1
The optional @linked-data-uri attribute is also included.
 <iati-activity xml:lang="en" default-currency="USD" last-updated-datetime="2014-09-10T07:15:37Z" linked-data-uri="http://data.example.org/123456789" hierarchy="1">

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




The version attribute was removed.


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

Developer tools

Find the source of this documentation on github: