Skip to main content
IATI - International Aid Transparency Initiative
  • Lang:
  • EN
  • FR
  • News
  • Events
  • Contact
  • About

    About IATI

    Our work involves making data on development and humanitarian spending and projects easier to access, use and understand. Organisations publish information according to the rules and guidance set out in the IATI Standard and this data is freely available and open to anyone in the world.

    Read more

    Introduction to IATI

    Read basic information about our initiative.

    • What is IATI?
    • Who is IATI for?
    • Why use IATI?

    Case studies

    See how IATI data is used to improve decisions and accountability.

    • Powering rapid responses to food and nutritional insecurity
    • Making overseas development assistance accountable in the Netherlands
  • Using Data

    Using IATI data

    IATI data can be an invaluable resource for anyone searching for information on development or humanitarian spending and projects.

    Read more

    Tools to access IATI data

    There are a range of tools for people wanting to use IATI data, designed for different audiences and use cases.

    Read more

    d-portal

    Search key data on development and humanitarian activities presented in charts, graphs and maps. Recommended for users who are new to IATI.

    Visit d-portal

    Country Development Finance Data

    Access and download data on development and humanitarian activities, presented simply by country, reporting organisation and sector.

    Visit CDFD

    Other resources

    • IATI Datastore
    • IATI Virtual Training for Civil Society
  • Publishing Data

    How to publish data

    Find out how to register with IATI and publish data.

    Read more

    IATI Publisher

    A free online tool which lets you register with IATI and publish data on your development and humanitarian activities.

    Visit IATI Publisher

    IATI Validator

    Check if your data aligns with the rules and guidance of the IATI Standard. Run checks on data files published by any organisation.

    Visit IATI Validator

    IATI Registry

    Register your data files here and find details of all organisations that publish IATI data.

    Visit IATI Registry
  • IATI Standard

    IATI Standard

    The IATI Standard is a set of rules and guidance on how to publish useful development and humanitarian data. Find out the full range of data included in the IATI Standard and more about its technical format.

    Read more

    What data should I publish?

    Understand what information you can publish and how to prepare it.

    Standard documentation

    Find details of all the elements and attributes that can be included in IATI data.

    • Activity Standard
    • Organisation Standard
    • Topic-specific guidance

    Developer documentation

    Explore how IATI data and the schema can be imported and used in different platforms.

    • IATI Developer Documentation
    • IATI Datastore
  • Governance

    Governance

    Learn about how IATI is funded, governed and run.

    Read more

    Who runs IATI?

    Meet the Governing Board and Secretariat to understand their roles and responsibilities.

    Governing Board and Secretariat

    Members

    IATI is governed and funded by our members.

    List of members
    • IATI Strategic Plan 2020-2025
    • Finances
    • IATI workplan
    • Annual reports
    • Governance documents
  • Get Involved

    Get Involved

    Find out how to join IATI as a member, engage with IATI’s community and access useful resources about the initiative.

    Read more

    IATI Community

    Engage in IATI's Communities of Practice.

    IATI Connect

    Becoming a member

    Discover the benefits of becoming an IATI member.

    Learn more

    IATI Presentation Materials

    Access presentation materials on IATI.

    Learn more
    • IATI Videos
    • IATI Membership Pack
    • Working Groups
    • Contact us
  • News
  • Events
  • Contact
  • Lang:
  • EN
  • FR

Reference

  • Version 2.03
    • Activity Standard
      • iati-activities
        • iati-activity
          • iati-identifier
          • reporting-org
            • narrative
          • title
            • narrative
          • description
            • narrative
          • participating-org
            • narrative
          • other-identifier
            • owner-org
              • narrative
          • activity-status
          • activity-date
            • narrative
          • contact-info
            • organisation
              • narrative
            • department
              • narrative
            • person-name
              • narrative
            • job-title
              • narrative
            • telephone
            • email
            • website
            • mailing-address
              • narrative
          • activity-scope
          • recipient-country
            • narrative
          • recipient-region
            • narrative
          • location
            • location-reach
            • location-id
            • name
              • narrative
            • description
              • narrative
            • activity-description
              • narrative
            • administrative
            • point
              • pos
            • exactness
            • location-class
            • feature-designation
          • sector
            • narrative
          • tag
            • narrative
          • country-budget-items
            • budget-item
              • description
                • narrative
          • humanitarian-scope
            • narrative
          • policy-marker
            • narrative
          • collaboration-type
          • default-flow-type
          • default-finance-type
          • default-aid-type
          • default-tied-status
          • budget
            • period-start
            • period-end
            • value
          • planned-disbursement
            • period-start
            • period-end
            • value
            • provider-org
              • narrative
            • receiver-org
              • narrative
          • capital-spend
          • transaction
            • transaction-type
            • transaction-date
            • value
            • description
              • narrative
            • provider-org
              • narrative
            • receiver-org
              • narrative
            • disbursement-channel
            • sector
              • narrative
            • recipient-country
              • narrative
            • recipient-region
              • narrative
            • flow-type
            • finance-type
            • aid-type
            • tied-status
          • document-link
            • title
              • narrative
            • description
              • narrative
            • category
            • language
            • document-date
          • related-activity
          • legacy-data
          • conditions
            • condition
              • narrative
          • result
            • title
              • narrative
            • description
              • narrative
            • document-link
              • title
                • narrative
              • description
                • narrative
              • category
              • language
              • document-date
            • reference
            • indicator
              • title
                • narrative
              • description
                • narrative
              • document-link
                • title
                  • narrative
                • description
                  • narrative
                • category
                • language
                • document-date
              • reference
              • baseline
                • comment
                  • narrative
                • dimension
                • document-link
                  • category
                  • description
                    • narrative
                  • document-date
                  • language
                  • title
                    • narrative
                • location
              • period
                • period-start
                • period-end
                • target
                  • comment
                    • narrative
                  • dimension
                  • document-link
                    • category
                    • description
                      • narrative
                    • document-date
                    • language
                    • title
                      • narrative
                  • location
                • actual
                  • comment
                    • narrative
                  • dimension
                  • document-link
                    • category
                    • description
                      • narrative
                    • document-date
                    • language
                    • title
                      • narrative
                  • location
          • crs-add
            • other-flags
            • loan-terms
              • repayment-type
              • repayment-plan
              • commitment-date
              • repayment-first-date
              • repayment-final-date
            • loan-status
              • interest-received
              • principal-outstanding
              • principal-arrears
              • interest-arrears
            • channel-code
          • fss
            • forecast
      • Activity Standard Summary Table
      • Example Usage XML
    • Organisation Standard
      • iati-organisations
        • iati-organisation
          • organisation-identifier
          • name
            • narrative
          • reporting-org
            • narrative
          • total-budget
            • period-start
            • period-end
            • value
            • budget-line
              • value
              • narrative
          • recipient-org-budget
            • recipient-org
              • narrative
            • period-start
            • period-end
            • value
            • budget-line
              • value
              • narrative
          • recipient-region-budget
            • recipient-region
              • narrative
            • period-start
            • period-end
            • value
            • budget-line
              • value
              • narrative
          • recipient-country-budget
            • recipient-country
              • narrative
            • period-start
            • period-end
            • value
            • budget-line
              • value
              • narrative
          • total-expenditure
            • period-start
            • period-end
            • value
            • expense-line
              • value
              • narrative
          • document-link
            • title
              • narrative
            • description
              • narrative
            • category
            • language
            • document-date
            • recipient-country
              • narrative
      • Organisation Standard Summary Table
      • Example Usage XML
    • Codelists
      • Activity Date Type
      • Activity Scope
      • Activity Status
      • Aid Type
      • Aid Type (category)
      • Aid Type Vocabulary
      • Budget Identifier
      • Budget Identifier Sector
      • Budget Identifier Sector (category)
      • Budget Identifier Vocabulary
      • Budget Not Provided
      • Budget Status
      • Budget Type
      • CRS Additional Other Flags
      • CRS Channel Code
      • Cash and Voucher Modalities
      • Collaboration Type
      • Condition Type
      • Contact Type
      • Country
      • Currency
      • DAC 3 Digit Sector
      • DAC 5 Digit Sector
      • Description Type
      • Disbursement Channel
      • Document Category
      • Document Category (category)
      • Earmarking Category
      • File Format
      • Finance Type
      • Finance Type (category)
      • Flow Type
      • Gazetteer Agency
      • Geographic Exactness
      • Geographic Location Class
      • Geographic Location Reach
      • Geographic Vocabulary
      • Geographical Precision
      • Humanitarian Scope Type
      • Humanitarian Scope Vocabulary
      • IATI Organisation Identifier
      • Indicator Measure
      • Indicator Vocabulary
      • Language
      • Loan Repayment Period
      • Loan Repayment Type
      • Location Type
      • Location Type (category)
      • Organisation Identifier
      • Organisation Registration Agency
      • Organisation Role
      • Organisation Type
      • Other Identifier Type
      • Policy Marker
      • Policy Marker Vocabulary
      • Policy Significance
      • Publisher Type
      • Region
      • Region Vocabulary
      • Related Activity Type
      • Result Type
      • Result Vocabulary
      • Sector Vocabulary
      • Tag Vocabulary
      • Tied Status
      • Transaction Type
      • UN Sustainable Development Goals (SDG)
      • UN Sustainable Development Goals (SDG) Targets
      • Verification Status
      • Version
      • Vocabulary
    • Rulesets
      • IATI Ruleset Spec - JS Edition
      • Standard Ruleset
    • Schema
    • Namespaces & Extensions
    • Reference
  • Upgrades
  • How we manage the standard
    • All versions
    • IATI codelist management
    • Previous upgrade process
    • Upgrade process
  • Upgrade changelogs
    • Non-Core Codelist Changelog
    • Decimal Upgrade to 2.03
      • 2.03 Changelog
    • Decimal Upgrade to 2.02
      • 2.02 Changelog
    • Integer Upgrade to 2.01
      • 2.01 Changelog
      • 2.01 Headlines
      • Migrating from versions 1.x to version 2.01
    • Version 1 upgrades
      • Decimal Upgrade to 1.05
        • 1.05 changelog
      • Decimal Upgrade to 1.04
        • 1.04 changes
        • Location: summary of changes in IATI Standard version 1.04
      • Decimal Upgrade to 1.03
        • 1.03 changes
      • Decimal Upgrade to 1.02
        • 1.02 changes
  • IATI Standard Publishing Guidance: How to suggest changes

2.01 Changelog

Changes / additions to IATI Standard for version 2.01

Note: Version 2.01 was released on Tuesday 6 January 2015.

Contents

  • 2.01 Changelog

    • Schema Changes

      • Activities schema

        • Activity Website: Removed Element

        • Contact Info - Department: New Element

        • Description: Removed Attributes

        • Document Link: Bug Fix

        • Freetext: Amended Elements

        • IATI Activity: Removed Attribute

        • Location: Removed Elements

        • Location: Removed Attributes

        • Narrative: New Elements

        • Other Flags: Renamed Element

        • Other Identifier: New Child Elements

        • Other Identifier: Removed / New Attributes

        • Planned Disbursement: Removed/Renamed Attributes

        • Transaction: New Child Elements

      • Organisations schema

        • Budget Line: New Element

        • Document Link: Bug Fix

        • Document Link: New Child Element

        • Freetext: Amended Elements

        • IATI Identifier: Renamed Element

        • Narrative: New Elements

        • IATI Organisation: Removed Attribute

      • Common schema

      • XML supplementary schema

      • Registry record schema

    • Codelist Changes

      • New Codelists

        • IATI Organisation Identifier: New codelist

        • Other Identifier Type: New Codelist

        • Policy Marker Vocabulary: New codelist

        • Sector Vocabulary: New codelist

        • Version: New Codelist

      • Embedded codelist updates

        • Aid Type Flag: Renamed codelist

        • Activity Date Type: Amended codes

        • Document Category: New codes

        • Gazetteer Agency: Amended codes

        • Organisation Role: Amended codes

        • Policy Marker Vocabulary (was Vocabulary): Amended codes

        • Related Activity Type: New code

        • Sector Vocabulary (was Vocabulary): Amended codes

        • Transaction Type: Amended codes

        • Vocabulary: Removed / split codelist

Schema Changes

A full diff of all schema changes in 2.01 can be found in the IATI GitHub

Activities schema

Activity Website: Removed Element

Element: activity-website (discussion | guidance)

1.0x

2.01

activity-website (removed)

Contact Info - Department: New Element

Element: contact-info/department (discussion | guidance)

1.0x

2.01

(none) contact-info/department

Description: Removed Attributes

  • Element: country-budget-items/budget-item/description

  • Element: result/description

  • Element: result/indicator/description

(discussion | guidance)

1.0x

2.01

country-budget-items/budget-item/description/@type (removed)
result/description/@type (removed)
result/indicator/description/@type (removed)

Document Link: Bug Fix

Inconsistencies in the document-link element were identified and applied, around the mandatory use of the language and title child elements.

  • Element: document-link

(discussion )

Freetext: Amended Elements

The ability to add free text has been removed from the following elements:

(discussion | guidance)

  • Element: activity-status

  • Element: activity-scope

  • Element: collaboration-type

  • Element: default-finance-type

  • Element: default-flow-type

  • Element: default-aid-type

  • Element: default-tied-status

  • Element: transaction/transaction-type

  • Element: transaction/flow-type

  • Element: transaction/aid-type

  • Element: transaction/finance-type

  • Element: transaction/tied-status

  • Element: transaction/disbursement-channel

  • Element: document-link/category

  • Element: document-link/language

  • Element: related-activity

  • Element: crs-add/loan-terms/repayment-type

  • Element: crs-add/loan-terms/repayment-plan

  • Element: location/exactness

  • Element: location/location-id

  • Element: location/administrative

IATI Activity: Removed Attribute

Element: iati-activity (discussion | guidance)

1.0x

2.01

iati-activity/@version (removed)

Location: Removed Elements

Element: location (discussion | guidance)

1.0x

2.01

location/coordinates (removed)
location/gazetteer-entry (removed)
location/location-type (removed)

Location: Removed Attributes

Element: location (discussion | guidance)

1.0x

2.01

location/@percentage (removed)
location/administrative/@country (removed)
location/administrative/@adm1 (removed)
location/administrative/@adm2 (removed)

Narrative: New Elements

A narrative child element was added to the following elements, to enable the inclusion free text.

(discussion | guidance)

  • Element: reporting-org/narrative

  • Element: title/narrative

  • Element: description/narrative

  • Element: participating-org/narrative

  • Element: activity-date/narrative

  • Element: contact-info/organisation/narrative

  • Element: contact-info/department/narrative

  • Element: contact-info/person-name/narrative

  • Element: contact-info/job-title/narrative

  • Element: contact-info/mailing-address/narrative

  • Element: recipient-country/narrative

  • Element: recipient-region/narrative

  • Element: location/name/narrative

  • Element: location/description/narrative

  • Element: location/activity-description/narrative

  • Element: sector/narrative

  • Element: country-budget-items/budget-item/description/narrative

  • Element: policy-marker/narrative

  • Element: transaction/description/narrative

  • Element: transaction/sector/narrative

  • Element: transaction/recipient-country/narrative

  • Element: transaction/recipient-region/narrative

  • Element: document-link/title/narrative

  • Element: conditions/condition/narrative

  • Element: result/title/narrative

  • Element: result/description/narrative

  • Element: result/indicator/title/narrative

  • Element: result/indicator/description/narrative

  • Element: result/indicator/baseline/comment/narrative

  • Element: result/indicator/period/target/comment/narrative

  • Element: result/indicator/period/actual/comment/narrative

Other Flags: Renamed Element

The aid-type-flag element has been renamed to other-flags.

Element: crs-add/other-flags (discussion | guidance)

1.0x

2.01

aid-type-flag other-flags

Other Identifier: New Child Elements

The following elements were added to the other-identifier element:

(discussion | guidance)

  • Element: other-identifier/owner-org

  • Element: other-identifier/owner-org/narrative

Other Identifier: Removed / New Attributes

Element: other-identifier (discussion | guidance)

1.0x

2.01

other-identifier/@owner-name (removed)
other-identifier/@owner-ref (removed)
(none) other-identifier/@ref
(none) other-identifier/@type

Planned Disbursement: Removed/Renamed Attributes

Element: planned-disbursement (discussion | guidance)

1.0x

2.01

(none) planned-disbursement/@type
planned-disbursement/@last-updated (removed)

Transaction: New Child Elements

The following elements were added to the transaction element:

(discussion | guidance)

  • Element: transaction/sector

  • Element: transaction/recipient-country

  • Element: transaction/recipient-region

Organisations schema

Budget Line: New Element

A new budget-line element was added to the following elements.

(discussion | guidance)

  • Element: total-budget/budget-line

  • Element: recipient-org-budget/budget-line

  • Element: recipient-country-budget/budget-line

Document Link: Bug Fix

Inconsistencies in the document-link element were identified and applied, around the mandatory use of the language and title child elements.

  • Element: document-link

(discussion )

Document Link: New Child Element

The recipient-country child element was added to the iati-organisation/document-link element:

Element: document-link/recipient-country/narrative (discussion | guidance)

Freetext: Amended Elements

The ability to add free text has been removed from the following element:

(discussion | guidance)

  • Element: document-category

IATI Identifier: Renamed Element

The iati-organisation/iati-identifier element has been renamed to iati-organisation/organisation-identifier.

Element: iati-organisation/organisation-identifier (discussion | guidance)

1.0x

2.01

iati-organisation/iati-identifier iati-organisation/organisation-identifier

Narrative: New Elements

A narrative child element was added to the following elements, to enable the inclusion free text.

(discussion | guidance)

  • Element: reporting-org/narrative

  • Element: name/narrative

  • Element: document-link/title/narrative

  • Element: document-link/recipient-country/narrative

  • Element: recipient-country-budget/recipient-country/narrative

  • Element: recipient-org-budget/recipient-org/narrative

IATI Organisation: Removed Attribute

Element: iati-organisation (discussion | guidance)

1.0x

2.01

iati-organisation/@version (removed)

Common schema

Many substantial changes were made in 2.01. Both the organisation and activity schema draw on the common schema for common definitions of elements and types. The changes in the common schema are reflected in the sections above, so are not given in detail here. For further information see the CHANGES.txt file that can be found with the schema

XML supplementary schema

No substantial changes were made in 2.01, aside from essential version references.

Registry record schema

No substantial changes were made in 2.01, aside from essential version references.

Codelist Changes

New Codelists

IATI Organisation Identifier: New codelist

The IATIOrganisationIdentifier codelist has been created.

Codelist: IATIOrganisationIdentifier (discussion)

Other Identifier Type: New Codelist

Codelist: OtherIdentifierType (discussion | guidance)

Code

Name

Description

A1 Reporting Organisation’s internal activity identifier (none)
A2 CRS Activity identifier (none)
A3 Previous Activity Identifier The standard insists that once an activity has been reported to IATI its identifier MUST NOT be changed, even if the reporting organisation changes its organisation identifier. There may be exceptional circumstances in which this rule cannot be followed, in which case the previous identifier should be reported using this code.
A9 Other Activity Identifier (none)
B1 Previous Reporting Organisation Identifier (none)
B9 Other Organisation Identifier (none)

Policy Marker Vocabulary: New codelist

The PolicyMarkerVocabulary has been created, split from the deleted Vocabulary codelist.

Codelist: SectorVocabulary (discussion)

Sector Vocabulary: New codelist

The SectorVocabulary has been created, split from the deleted Vocabulary codelist.

Codelist: SectorVocabulary (discussion)

Version: New Codelist

Codelist: Version (discussion | guidance)

Code

Name

Description

URL

1.01 (none) (none) http://iatistandard.org/101/
1.02 CRS Activity identifier (none) http://iatistandard.org/102/
1.03 (none) (none) http://iatistandard.org/103/
1.04 (none) (none) http://iatistandard.org/104/
1.05 (none) (none) http://iatistandard.org/105/
2.01 (none) (none) http://iatistandard.org/201/

Embedded codelist updates

Aid Type Flag: Renamed codelist

The AidTypeFlag codelist has been renamed to CRSAddOtherFlags.

Codelist: CRSAddOtherFlags (discussion | guidance)

1.0x

2.01

AidTypeFlag CRSAddOtherFlags

Activity Date Type: Amended codes

Codelist: ActivityDateType Type (discussion | guidance)

1.0x

2.01

start-planned 1
start-actual 2
end-planned 3
end-actual 4

Document Category: New codes

Codelist: DocumentCategory (discussion | guidance)

Code

Name

Description

A12 Activity web page (none)
B16 Organisation web page (none)
B17 Country/Region web page (none)
B18 Sector web page (none)

Gazetteer Agency: Amended codes

Codelist: GazetteerAgency (discussion | guidance)

1.0x

2.01

GEO 1
NGA 2
OSM 3

Organisation Role: Amended codes

Codelist: OrganisationRole (discussion | guidance)

1.0x

2.01

Funding 1
Accountable 2
Extending 3
Implementing 4

Policy Marker Vocabulary (was Vocabulary): Amended codes

Codelist: PolicyMarkerVocabulary (discussion | guidance)

1.0x

2.01

DAC 1
RO 99

Related Activity Type: New code

Codelist: RelatedActivityType (discussion | guidance)

Code

Name

Description

5 Third Party A report by another organisation on the same activity (excluding activities reported as part of financial transactions - eg. provider-activity-id - or a co-funded activity using code = 4)

Sector Vocabulary (was Vocabulary): Amended codes

Codelist: SectorVocabulary (discussion | guidance)

1.0x

2.01

ADT 1
COFOG 2
DAC 3
DAC-3 4
ISO 5
NACE 6
NTEE 7
WB 8
RO 99

Transaction Type: Amended codes

Codelist: TransactionType (discussion | guidance)

1.0x

2.01

IF 1
C 2
D 3
E 4
IR 5
LR 6
R 7
QP 8
Q3 9
CG 10

Vocabulary: Removed / split codelist

The Vocabulary has been removed, and split into two new codelists: SectorVocabulary and PolicyMarkerVocabulary.

Codelist: SectorVocabulary | SectorVocabulary (discussion)

Useful links

  • Privacy policy
  • Translation FAQs
  • Data removal

Newsletter

Copyright IATI 2025. All rights reserved

  • Twitter
  • YouTube