Technical Paper
Format and Definitions of IATI Standard for remaining data
(updated on February 18, 2011)
Introduction
The detailed codes lists to be used are available at the online forum (www.iaticonsultation.org). The technical formats for publishing are unchanged from
those included in each of the consultation papers; some definitions have been updated in the light of the comments received. Now approved, the formats will be
added to the repository of the official standard (http://iatistandard.org), available in English, French and Spanish. The Standard is a “living standard”
that will be subject to modifications in the light of implementation experience.
Documents
Section
Item
Definition
Data Format XML
Occurs Examples and Notes
Section
Item
Document Link
Definition
Data Format XML
Information pertaining to a
published document that is
related to an organisation
or an activity
Occurs Examples and Notes
0..*
url
The web address where the u.r.l.
document can be
downloaded.
document-link/@url
1..1
<document-link
url="http://reporting.org/activities/documents/xx546.doc"/>
document
format
The Internet Media Type
("MIME type") of the
document linked to, as
defined and maintained by
the Internet Assigned
Numbers Authority.
File Format
Code
document-link/@format
1..1
<document-link format="application/msword">
language
The ISO 639 code for the
language of the document.
Only required if different
from the activity’s default
language.
Language
Code
document-link/@xml:lang
0..1
<document-link xml:lang="en">
category
The type of content
document- document-link/category
contained within the
link/category
document. If the document
spans multiple content
types this element should
be repeated.
category-code The code for the content
type
Document
Category
Code
document-link/category/@code
0..*
1..1
<category code="A04"/>
Section
Item
Definition
Data Format XML
categorydescription
A description of the content Text
type
document-link/category/text()
0..1
<category code="A04">Conditions</category>
title
The full title of the
document
document-link/title/text()
1..1
<title>Project Conditions</title>
Text
Occurs Examples and Notes
Results (Optional)
The suggested data format for results is a model to allow those that already publish results as data to do so in an internationally comparable format, should
they so wish. Should future international agreements elsewhere on results data supersede the suggested data format, this will be updated accordingly.
Section
Item
Definition
Data
Format
Results
Result
a text description of the
Text
result the activity is aiming
to achieve e.g. build 10
schools
XML
Occurs Examples and Notes
Results
0..1
<results>
results/result/text()
1..*
<results>
<result result-type=”output”>build 10 schools
</result>
</results>
Result-type
whether it is an output,
outcome, or impact
indicator
Code list
Indicator
The indicator(s) that meet Text
the results. There can be
multiple indicators for each
‘result’
results/result/@result-type
1.1
results/result/indicator/
0.*
<results>
<result result-type=”output”>build 10 schools
<indicator measure=”unit”>
<indicator-description>number of schools built</indicatordescription>
</indicator>
</result>
</results>
Section
Item
Definition
Measure
Data
Format
XML
Occurs Examples and Notes
The type of measurement Code list
for the indicator value e.g.
unit, percentage
results/result/indicator/@measure
0.*
Indicator
description
The description of the
indicator
results/result/indicator/text()
Baseline
A comment on the baseline Text
measure
Text
results/result/indicator/baseline/text()
0.1
<indicator measure=”percentage”>
<indicator-description>gross primary school enrolment
rate</indicator-description>
<baseline year=”2008” value=”55%”>Baseline
comment</baseline>
<target year=”2015” value=”85%”>Target
Comment</target>
<actual year=”2010” value=”62%”>Actual
Comment</actual>
</indicator>
Year
The Year the baseline
measure was taken
YYYY
results/result/indicator/baseline/@year
0.1
Value
The baseline measure.
Text
results/result/indicator/baseline/@value
0.1
Target
The target comment for
Text
the indicator. There can be
many targets set as
milestone measures
results/result/indicator/target/text()
0.*
Target-date
The year the result is
aiming to be realised
results/result/indicator/target/@year
0.*
YYYY
Section
Item
Definition
Data
Format
XML
Occurs Examples and Notes
Value
The target value
Text
results/result/indicator/target/@value
0.*
Actual
A record of the achieved
result, or an interim
measure to track progress
Text
results/result/indicator/actual/text ()
0.*
Actual-date
The year the actual
measure was taken
YYYY
results/result/indicator/actual/@year
0.*
Value
The actual measure.
Text
results/result/indicator/actual/@value
0.*
Conditions
Conditions
attached
A yes/no value stating
Yes/No
whether there are
conditions attached to the
activity
conditions
0..1
conditions/@attached
1..1
conditions/condition
1..*
<conditions attached=”no” />
Following three items are optional
condition
Multiple conditions
allowed
type
Condition type – e.g.
policy, performance.
description
The text describing the
Text
conditions attached to the
activity
Condition
Type Code
conditions/condition/@type
<condition type=”policy” />
conditions/condition/text()
<condition type=”policy”>
text of conditions to go here</condition>
Activity Budget and Planned Disbursements
Section
Item
Definition
Budget
budget
The value of the aid
activity's budget for each
financial year as in the
original project document.
type
Data Format XML
budget
Occurs Examples and Notes
0..*
This is most useful by the financial year of the recipient
country.
(If that is not available, can be provided for each calendar
year and/or financial year of the donor.)
Is budget original or revised Budget Type budget/@type
Code
1..1
<budget type=”original”>
period-start
ISO 8601 code for the start Date
date of the reporting period
(yyyy-mm-dd).
budget/period-start
1..1
<period-start>2011-01-01</period-start>
period-end
ISO 8601 code for the end Date
date of the reporting period
(yyyy-mm-dd).
budget/period-end
1..1
<period-end>2011-12-31</period-end>
value
The total budget for the
Integer
specified period in the
specified currency. (Positive
integer.)
budget/value/text()
1..1
<value value-date="2010-10-01">700000</value>
value-date
Date of value for currency
conversions.(yyyy-mm-dd)
Date
budget/value/@value-date
1..1
<value value-date="2010-10-01">700000</value>
currency
The ISO 4217 code for the
currency in which the
project is denominated.
[only if different to default
currency]
Currency
Code
budget/value/@currency
0..1
<value currency="GBP" value-date="2010-1001">700000</value>
Section
Item
Definition
Data Format XML
Occurs Examples and Notes
Planned
Disbursement
planneddisbursement
The amount it is planned to
disburse on the activity in
each of the next three
financial years.
planned-disbursement
date-updated
The date on which this line Date
of information was last
updated. Previous updates
for the same period should
also be reported.
planned-disbursement/@updated
period-start
ISO 8601 code for the start Date
date of the reporting period
(yyyy-mm-dd).
planned-disbursement/period-start
1..1
<period-start>2011-01-01</period-start>
period-end
ISO 8601 code for the end Date
date of the reporting period
(yyyy-mm-dd).
planned-disbursement/period-end
1..1
<period-end>2011-12-31</period-end>
value
The amount to be disbursed Integer
in the specified currency.
(Positive integer.)
planned-disbursement/value/text()
1..1
<value value-date="2010-11-01">7000</value>
value-date
Date of value for currency
conversions.(yyyy-mm-dd)
Date
planned-disbursement/value/@value-date 1..1
<value value-date="2010-11-01">7000</value>
currency
The ISO 4217 code for the
currency of the
disbursement. [only if
different to default
currency
Currency
Code
planned-disbursement/value/@currency
<value currency="GBP" value-date="2010-1101">7000</value>
0..*
This is most useful by the financial year of the recipient
country.
(If that is not available, can be provided for each calendar
year and/or financial year of the donor.)
<planned-disbursement updated=”2010-12-01”>
0..1
Recipient Country Budget Identifier
Section
Recipient
Country
Budget
Identifier
Item
Definition
To be developed
Data Format XML
Occurs Examples and Notes