| A | B | C | D | E | F | G | |
|---|---|---|---|---|---|---|---|
1 | Section | Item | Definition | Data Format | XML | Occur | Examples and Notes |
2 | Container Elements | ||||||
3 | File Header | iati-activities | 1..1 | ||||
4 | IATI version | The version of the IATI Standard that has been used to compile this file. If omitted current version is assumed. | Text | iati-activities/@version | 0..1 | <iati-activities version="1.00"> | |
5 | generated-datetime | The date and time this file was generated. | DateTime | iati-activities/@generated-datetime | 0..1 | <iati-activities generated-datetime="2010-10-27T18:00:00"> | |
6 | Record Header | iati-activity | 1..* | ||||
7 | default language | This field allows a default language for an entire activity report. The language should be the same as is used in formal documents with the aid recipient. In most cases all the activity information will be provided in the same language. If omitted it is necessary to specify the language in all text fields throughout the record. The ISO 639-1 Language Code. | Language Code | iati-activity/@xml:lang | 0..1 | <iati-activity xml:lang="en"> | |
8 | default currency | The default currency for an entire activity report. In most cases, all financial figures will be provided using the same currency. If omitted it is necessary to specify the currency for each monetary value in the record. The ISO 4217 code. Different currencies may be specified at transaction level. | Currency Code | iati-activity/@default-currency | 0..1 | <iati-activity default-currency="USD"> | |
9 | hierarchical position | The hierarchical level within the reporting organisation's subdivision of its units of aid. (eg activity = 1; sub-activity = 2; sub-sub-activity = 3) | Integer | Iati-activity/@hierarchy | 0..1 | <iati-activity hierarchy="2">GB-1-105838-1</iati-activity> | |
10 | last-updated-datetime | The date and time this record was last updated. | DateTime | iati-activity/@last-updated-datetime | 0..1 | <iati-activity last-updated-datetime="2010-10-27T18:00:00"> | |
11 | Identification | ||||||
12 | Reporting Organisation | The name and unique identifier of the organisation publishing the information. | reporting-org | 1..1 | |||
13 | identifier | A unique identifier for the organisation | Organisation Identifier | reporting-org/@ref | 1..1 | <reporting-org ref="GB-1"/> | |
14 | type | Type of organisation (government, multilateral, private, PPP, NGO, foundation, etc) | Organisation Type Code | reporting-org/@type | 0..1 | <reporting-org ref="GB-1" type="10"/> | |
15 | name | The name of the organisation | reporting-org/text() | 0..1 | <reporting-org>Department for International Development</reporting-org> | ||
16 | language | ISO 639-1 code for language of the name. [Only if different to default language.] | Language Code | reporting-org/@xml:lang | 0..1 | <reporting-org xml:lang="fr">Departement pour le developpement international</reporting-org> | |
17 | IATI activity identifier | A globally unique identifier for this activity. This should be in the form of the IATI Organisation Identifier (for the reporting organisation) concatenated to that organisation's activity identifier. | iati-identifier | 1..1 | |||
18 | IATI activity identification string | The IATI identification string. | Text | iati-identifier/text() | 1..1 | <iati-identifier>GB-1-105838-1</iati-identifier> | |
19 | Other activity identifiers | An activity can be defined and/or reported on by multiple organisations. All such identifiers can be reported here. | other-identifier | 0..* | |||
20 | organisation-Identifier | A unique identifier for the owner of this ID. | Organisation Identifier | other-identifier@owner-ref | 0..1 | <other-identifier owner-ref="GB-1">105838-1</other-identifier> | |
21 | organisation-name | A human-readable name for the owner of this ID | Text | other-identifier/@owner-name | 0..1 | <other-identifier owner-ref="GB-1" owner-name="DFID">105838-1</other-identifier> | |
22 | activity identification string | The activity identification string. | Text | other-identifier/text() | 1..1 | <other-identifier owner-ref="GB-1" owner-name="DFID">105838-1</other-identifier> | |
23 | Basic Activity Information | ||||||
24 | Activity Title | The title of the aid activity (preferably official name used in project documents - avoid obscure acronyms). | title | 1..* | |||
25 | text | The text for the title. | Text | title/text() | 1..1 | <title>Support to the Poverty Reduction Strategy Process</title> | |
26 | language | The ISO 639-1 code for the language of the text. [Only if different to default language.] | Language Code | title/@xml:lang | 0..1 | <title xml:lang="fr">Appui au processus de Strategie de Reduction</title> | |
27 | Activity Description | Long description summarising the specific purpose or objective of the activity. | description | 0..* | |||
28 | type | The type of description (summary, objectives, etc.). | Description Type Code | description/@type | 0..1 | <description type="Objectives">The aims of the activity are to ... </description> | |
29 | text | The text for the description. | Text | description/text() | 1..1 | <description>A general description of the activity. ...</description> | |
30 | language | The ISO 639-1 code for the language of the text. [Only if different to default language.] | Language Code | description/@xml:lang | 0..1 | <description xml:lang=”en”>A general description of the activity. ...</description> | |
31 | Activity Status | The current stage of the aid activity at the time the IATI information is published/updated. The stages are based on an activity lifecycle. | activity-status | 0..1 | |||
32 | code | A code for the status (e.g. implementation). | Activity Status Code | activity-status/@code | 0..1 | <activity-status code="2"/> | |
33 | Text | Text describing the status. | Text | activity-status/@text | 0..1 | <activity-status code="2">Implementation</activity-status> | |
34 | language | The ISO 639-1 code for the language of the status text. [Only if different to default language.] | Language Code | activity-status/@xml:lang | 0..1 | <activity-status code="2"> xml:lang=”fr”>Implementation </activity-status> | |
35 | Activity Dates | The expected and actual start and completion dates of the activity, where start is the date of first disbursement for the activity and completion is the date of last disbursement for the activity. | activity-date | 0..* | |||
36 | Type | Date type (e.g. start-planned, end-actual). | Activity Date Type Code | activity-date/@type | 1..1 | <activity-date type="start-planned">2011</activity-date> | |
37 | iso-date | ISO 8601 date (yyyy-mm-dd). | Date | activity-date/@iso-date | 0..1 | <activity-date type="start-actual" iso-date="2010-03-22"/> | |
38 | text-date | General date text (e.g. 2011Q1). For recording less specific dates (month, quarter, year) where full (iso) date is not known. | Text | activity-date/text() | 0..1 | <activity-date type="start-planned">2011</activity-date> | |
39 | language | The language of the general date text. [Only if different to default language.] | Language Code | activity-date/@xml:lang | 0..1 | <activity-date type="start-planned" xml:lang=”en”>First Quarter 2011</activity-date> | |
40 | Activity Contacts | Contact details for the activity. Can be either a generic contact or specific individual providing there are no privacy concerns and there is an automatic update when individual changes job. | contact-info | 0..* | |||
41 | organisation | contact-info/organisation | 0..1 | ||||
42 | organisation name | The name of the contact's organisation. | Text | contact-info/organisation/text() | 0..1 | <organisation>DFID</organisation> | |
43 | person | contact-info/person-name | 0..1 | ||||
44 | name | The name of the contact at the organisation. | Text | contact-info/person-name/text() | 0..1 | <person-name>Joe Brown</person-name> | |
45 | phone | contact-info/telephone | 0..* | ||||
46 | telephone | The contact's telephone number. | Text | contact-info/telephone/text() | 0..1 | <telephone>+442071239876</telephone> | |
47 | contact-info/email | 0..* | |||||
48 | The contact's email address. | Email address | contact-info/email/text() | 0..1 | <email>jbrown@dfid.gov</email> | ||
49 | address | contact-info/mailing-address | 0..* | ||||
50 | address | The contact's mailing address. | Text | contact-info/mailing-address/text() | 0..1 | <mailing-address>1 Palace Street, London SW1E 5HE</mailing-address> | |
51 | Participating Organisations | ||||||
52 | Participating Organisation | The identity and role of each organisation in the activity (including the reporting organisation). | participating-org | 0..* | |||
53 | role | Roles: Funding - The country or institution which provides the funds; Extending - The government entity (central, state or local government agency or department), or agency within an institution, financing the activity from its own budget; Implementing - The intermediary between the extending agency and the ultimate beneficiary. Also known as executing agency or channel of delivery. They can be public sector, non-governmental agencies (NGOs), Public-Private partnerships, or multilateral institutions; Accountable - The government agency, civil society or private sector institution which is accountable for the implementation of the activity. | Organisation Role Code | participating-org/@role | 1..1 | <participating-org role="Extending" ref="41114">UNDP</participating-org> | |
54 | identifier | A unique identifier for the organisation. [ISO 3166 codes for countries] | Organisation Identifier | participating-org/@ref | 0..1 | <participating-org role="Extending" ref="41114">UNDP</participating-org> | |
55 | type | Type of organisation (government, multilateral, private, PPP, NGO, foundation, etc) | Organisation Type Code | participating-org/@type | 0..1 | <participating-org role="Extending" type="Multilateral" ref="41114">UNDP</participating-org> | |
56 | name | The name of the organisation (e.g. ‘United Nations Children's Fund’) | Text | participating-org/text() | 0..1 | <participating-org role="Extending" ref="41114">UNDP</participating-org> | |
57 | language | The ISO 639-1 code for the language of the name and acronym. [Only if different to default language.] | Language Code | participating-org/@xml:lang | 0..1 | <participating-org role="Extending" ref="41114" xml:lang=”fr”>PNUD</participating-org> | |
58 | Geopolitical Information | ||||||
59 | Recipient Country | The country(ies) for whose benefit the aid flow is provided, if applicable. Repeat for each country where known. | recipient-country | 0..* | |||
60 | code | ISO 3166 country code | Country Code | recipient-country/@code | 1..1 | <recipient-country code="CG"/> | |
61 | name | Name of the country | Text | recipient-country/text() | 0..1 | <recipient-country code="CG">Democratic Republic of Congo</recipient-country> | |
62 | percentage | Percentage of activity commitment allocated to this country (if available) if more than one country is involved. If percentages are shown for each country they must add to 100% for the activity being reported. | Integer | recipient-country/@percentage | 0..1 | <recipient-country code="CG" percentage="60"/><recipient-country code="AO" percentage="40"/> | |
63 | language | The ISO 639-1 code for the language of the name. [Only if different to default language.] | Language Code | recipient-country/@xml:lang | 0..1 | <recipient-country code="CG" xml:lang=”fr”>Republique Democratique du Congo </recipient-country> | |
64 | Recipient region | Supra-national: The geographical or administrative region grouping various countries (e.g. Sub-Saharan Africa, Mekong Delta). Use ‘global’ for activities benefiting substantially all developing countries. If percentages are shown for each region they must add to 100% for the activity being reported. | recipient-region | 0..* | |||
65 | code | IATI region code | Region Code | recipient-region/@code | 0..1 | <recipient-region code="289"/> | |
66 | name | Name of the region | Text | recipient-region/text() | 0..1 | <recipient-region>Mano River Basin</recipient-region> | |
67 | percentage | Percentage of activity commitment allocated to this region (if available). | Integer | recipient-region/@percentage | 0..1 | <recipient-region code="289" percentage="60"/><recipient-region code="189" percentage="40"/> | |
68 | language | The ISO 639-1 code for the language of the name (only if different from the default language). | Language Code | recipient-region/@xml:lang | 0..1 | <recipient-region code="289" xml:lang=”es”>Africa subsahariana</recipient-region> | |
69 | Sub-national Geographic Location (Optional) | The sub-national geographical identification of the target locations of an activity. These can be described by coordinates, administrative areas or a textual description. The IATI standard on sub-national geocoding builds upon the UCDP/AidData methodology and was developed in consultation with the IATI Technical Advisory Group | location | 0..* | |||
70 | percentage | If more than one location is reported, percentage of activity commitment allocated to this location (if available). | Integer | location/@percentage | 0..1 | <location percentage="5"> | |
71 | location type | location/location-type | 0..1 | ||||
72 | type | The type of location - relevant to this activity. E.g. Kampala may be a city or a district. | Location Type Code | location/location-type/@code | 1..1 | <location-type code="PPL"/> | |
73 | description | The description of the location-type code | Text | location/location-type/text() | 0..1 | <location-type code="PPL">populated place</location-type> | |
74 | language | The language of the location-type description (if different from default language) | Language Code | location/location-type/@xml:lang | 0..1 | <location-type code="PPL" xml:lang-"en">populated place</location-type> | |
75 | location name | location/name | 1..* | ||||
76 | name | The name of the location | Text | location/name/text() | 1..1 | <name>Buwenge</name> | |
77 | language | For reporting the name in multiple languages where a location is commonly known by different names in different languages. (e.g. Ivory Coast, Cote DÕIvoire). | Language Code | location/name/@xml:lang | 0..1 | ||
78 | description | location/description | 0..* | ||||
79 | description | A free text description to clarify, if necessary, what the actual target of the activity is. | Text | location/description/text() | 1..1 | <description>Buwenge hospital</description> | |
80 | language | The ISO 639-1 code for the language of the description. [Only if different to default language.] | Language Code | location/description/ @xml:lang | 0..1 | <description xml:lang="en">Buwenge hospital</description> | |
81 | administrative | Definition of national and sub-national administrative divisions | location/administrative | 0..1 | <administrative country="AF" adm1="KAN">Kandahar Province, Afghanistan</administrative> | ||
82 | country | Only required for multi-country activities. | Country Code | location/administrative/ @country | 0..1 | ||
83 | adm1 | The first-level administrative subdivision code | Admin-1 Code | location/administrative/ @adm1 | 0..1 | ||
84 | adm2 | The second-level administrative subdivision code | Admin-2 Code | location/administrative/ @adm2 | 0..1 | ||
85 | administrative-description | Text description of national and sub-national administrative divisions | Text | location/administrative/text() | 0..1 | ||
86 | coordinates | The geographic coordinates of the location | location/coordinates | 0..1 | <coordinates latitude="0.651922" longitude="33.16983" precision="1"/> | ||
87 | latitude | The latitude coordinates. Decimal format. North = positive. South = negative. | Decimal | location/coordinates/ @latitude | 1..1 | ||
88 | longitude | The longitude coordinates. Decimal format. East = positive. West = negative. | Decimal | location/coordinates/ @longitude | 1..1 | ||
89 | precision | The precision category which defines the context of the reported coordinates | Precision Code | location/coordinates/ @precision | 0..1 | ||
90 | gazetteer-entry | Gazetteers are public registries of geographical data which store a range of attributes for each defined object. Coordinates, administrative areas, type of location, etc can all be retrieved from a gazetteer identifier. | location/gazetteer-entry | 0..* | <gazetteer-entry gazeteer-ref="geonames.org"> 167483</gazetteer-entry> | ||
91 | gazetteer-agency | The agency/gazetteer for which the corresponding identifier is a record key. | Gazetteer Agency Code | location/gazetteer-entry/@gazetteer-ref | 1..1 | ||
92 | gazetteer-identifier | The identifier that links coordinates to a gazetteer database record | Integer | location/gazetteer-entry/text() | 1..1 | ||
93 | Classifications | ||||||
94 | General / Detailed Sector | The specific area(s) of the recipient's economic or social development that the transfer intends to foster. Also known as purpose codes. | sector | 0..* | |||
95 | vocabulary | The sector vocabulary (DAC, OCHA, World Bank, AidData, etc.). If omitted, assume DAC. Allows for donors to enter their own internal sector codes. But where they have a mapping to the DAC standard (e.g. DAC members, WB, Reg Banks, UN agencies) should also record that here for international comparability. | Vocabulary Code | sector/@vocabulary | 0..1 | <sector vocabulary="WB" code="BC">Central government administration</sector> | |
96 | code | The code for the sector. | Sector Code | sector/@code | 0..1 | <sector code="13040"/> | |
97 | description | The description of the sector. | Text | sector/text() | 0..1 | <sector code="13040">STD control including HIV/AIDS</sector> | |
98 | percentage | Percentage share of commitment for this sector within the vocabulary. Shares required if more than one sector within any vocabulary for an activity and must add to 100% within that vocabulary. | Integer | sector/@percentage | 0..1 | <sector code="13040" percentage="32"/><sector code="13062" percentage="68"/> | |
99 | language | The ISO 639-1 code for the language of the sector name. [Only if different to default language.] | Language Code | sector/@xml:lang | 0..1 | <sector code="13040" xml:lang=”en”>STD control including HIV/AIDS</sector> | |
100 | Policy/ Thematic Markers | Indicators tracking key policy issues. This can be also used for donor specific thematic classifications | policy-marker | 0..* | |||