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.

    • How IATI works
    • Who is IATI for?
    • Why use IATI?
    • About the Standard
    • The IATI story so far

    Case studies

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

    • Madagascar case study
    • Oxfam Novib case study
    • AfDB's IATI portal improves development investments
  • 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

    Using the reference site

    IATI Reference is an ‘instruction manual’ giving details of all the ‘parts’ you’ll need to build your datafiles.

    • How to use IATI Reference

    Standard documentation

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

    • Activity Standard
    • Organisation Standard
    • Codelists

    Developer documentation

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

    • IATI Developer Documentation
    • IATI Datastore
  • 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 and resources
    • Types of data available
    • How do I use IATI data?
    • How to get help with using IATI data
    • IATI data use research
  • Tools & Resources

    Tools and resources

    Use IATI tools and resources to enable you to publish, improve and use IATI data.

    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

    IATI Datastore

    Use Datastore Search to download a wide range of IATI data in CSV, JSON and XML formats. Use IATI’s API to build complex searches.

    Visit Datastore

    IATI Validator

    Check if your data files align with the rules and guidance of the IATI Standard. Run checks on data files published by all other organisations.

    Visit Validator

    Additional IATI tools

    • IATI Registry
    • Country Development Finance Data
    • IATI Dashboard
    • API Gateway
    • Third-party tools and services for data use
  • Guidance & Support

    Guidance and support

    Find out how to publish data to the IATI Standard and improve your data by using our publishing guidance.

    Read more

    Standard overview

    Understand what data you can publish to IATI.

    • New: IATI CSO Course
    • Key qualities of IATI data
    • What data should I publish?
    • Donors' reporting requirements

    Publishing guidance

    Understand how to create, check and publish your IATI files.

    • Publishing checklist
    • How to create your IATI organisation identifier
    • Data quality and visualisation

    Standard guidance

    Find guides on to how interpret specific areas of the IATI Standard.

    • COVID-19 related data
    • Sustainable Development Goals (SDGs)

    Get support

    Contact the IATI Helpdesk with questions about using and publishing IATI data, and other technical enquiries.

  • 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

    Membership

    Discover the benefits of joining IATI as a member.

    Join IATI

    Present IATI

    Access custom presentation materials on IATI.

    Learn more
    • IATI Videos
    • IATI Membership Pack
    • Working Groups
    • External resources
  • Governance

    Governance

    IATI is governed and funded by our members and run by the Governing Board and Secretariat.

    Read more

    Who runs IATI?

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

    Governing Board and Secretariat

    Membership

    Discover the benefits of joining IATI as a member.

    List of members
    • IATI future hosting arrangements post-2022
    • IATI Strategic Plan 2020-2025
    • Finances
    • IATI workplan
    • Annual reports
    • Governance documents
    • IATI Members' Assembly 2023
  • 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.03 Changelog

Changes / additions to IATI Standard for version 2.03

Note: Version 2.03 was released on Monday 19th February 2018.

Contents

  • 2.03 Changelog

    • Schema Changes

      • Activities Schema

      • Organisations Schema

      • Activities and Organisations Schemas

    • Codelist Changes

      • Embedded to Non-Embedded:

      • New Codelists

      • Updated Codelists

    • Ruleset Changes

Schema Changes

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

These changes are also shown in the Final Technical Summary (spreadsheet).

Activities Schema

  • Added new @crs-channel-code attribute for the participating-org element (#338) (discussion link)

  • Added new tag element (as a child of the iati-activity element) (#342) (discussion link)

  • Updated definition: [recipient-country, recipient-region, sector] @percentage attribute (#343) (discussion link)

  • Updated definition: sector @vocabulary attribute (#344). The % sign was removed.

  • Updated definition: [transaction/aid-type, default-aid-type] @code attribute (#345) (discussion link)

  • Added new @vocabulary attributes for elements relating to aid-type (#346) (discussion link)

  • Updated definition: capital-spend @percentage attribute (#348) (discussion link)

  • Updated definition: related-activity element (#349) (discussion link)

  • Updated occurrence: default-aid-type element (#350) (discussion link)

  • Updated occurrence: transaction/aid-type element (#351) (discussion link)

Changes and Additions to the Result element:

  • Updated definition: result/indicator/reference @indicator-uri attribute (#347) (discussion link)

  • Updated occurrence: result/indicator/baseline element (#352) (discussion link)

  • Updated occurrence: result/indicator @value attributes (#353) (discussion link)

  • Updated occurrence: [result/indicator/period/target, result/indicator/period/actual] elements (#354) (discussion link)

  • Updated occurrence: result/indicator/period/target @value attribute (#355) (discussion link)

  • Updated occurrence: result/indicator/period/actual element (#356) (discussion link)

  • Updated occurrence: result/indicator/period/actual @value attribute (#358) (discussion link)

  • Added new document-link element (as a child of various result elements)(#359) (discussion link)

  • Added new reference element (as a child of the result element) (#362) (discussion link)

  • Added new @aggregation-status attribute for the result/indicator element (#363) (discussion link)

  • Added new location element (as a child of the result/indicator/baseline element) (#365) (discussion link)

  • Added new dimension element (as a child of the result/indicator/baseline element) (#366) (discussion link)

Organisations Schema

  • Updated definition: organisation-identifier element (#361) (discussion link)

Activities and Organisations Schemas

  • Updated definition: all @xml:lang attributes (#336) (discussion link)

  • Updated definition: [participating-org, planned-disbursement/provider-org, planned-disbursement/receiver-org, transaction/provider-org, transaction/receiver-org, recipient-org-budget/recipient-org] @ref attribute (#339) (discussion link)

  • Updated definition: reporting-org @ref attribute and iati-organisation/organisation-identifier element (#339) (discussion link)

  • Updated definition: reporting-org @secondary-reporter attribute (#340) (discussion link)

  • Updated definition: [recipient-region, recipient-region-budget, sector] @vocabulary-uri attribute (#341) (discussion link)

  • Added new description element (as a child of all document-link elements) (#357) (discussion link)

Codelist Changes

A full diff of all embedded codelist changes in 2.03 can be found in the IATI GitHub

Embedded to Non-Embedded:

Alongside 2.03, the following codelists have moved from Embedded to Non-Embedded (#114) (Discussion link):

  • ActivityScope

  • BudgetIdentifier

  • BudgetIdentifierSector-category

  • BudgetIdentifierSector

  • BudgetIdentifierVocabulary

  • CRSAddOtherFlags

  • ConditionType

  • ContactType

  • DescriptionType

  • DisbursementChannel

  • DocumentCategory-category

  • GeographicExactness

  • GeographicLocationClass

  • GeographicLocationReach

  • GeographicVocabulary

  • GeographicalPrecision

  • IndicatorMeasure

  • LoanRepaymentPeriod

  • LoanRepaymentType

  • OrganisationType

  • OtherIdentifierType

  • PolicyMarker

  • PolicyMarkerVocabulary

  • PublisherType

  • RegionVocabulary

  • ResultType

  • SectorVocabulary

  • TiedStatus

  • VerificationStatus

New Codelists

Non-Embedded:

  • Added AidTypeVocabulary Codelist (#185) (Discussion link)

  • Added BudgetNotProvided Codelist (#184) (Discussion link)

  • Added ResultVocabulary Codelist (#181) (Discussion link)

  • Added TagVocabulary Codelist (#178) (Discussion link)

Updated Codelists

Embedded:

  • Added codes: 12 ‘Outgoing Pledge’ and 13 ‘Incoming Pledge’ to TransactionType Codelist (#112) (Discussion link).

Non-Embedded:

  • Added codes: 11 ‘Local Government’, 24 ‘Partner Country based NGO’, 71 ‘Private Sector in Provider Country’, 71 ‘Private Sector in Aid Recipient Country’, 73 ‘Private Sector in Third Country’ and 90 ‘Other’ to OrganisationType Codelist (#113) (Discussion link)

  • Added codes: 3 ‘Nominal’, 4 ‘Ordinal’ and 5 ‘Qualitative’ to IndicatorMeasure Codelist (#179) (Discussion link)

  • Added Code 2.03 to Version (#238)

Ruleset Changes

A full diff of all Ruleset changes in 2.03 can be found in the IATI GitHub

  • Added rule: reference element (#48) (Discussion link)

  • Added rules: result @value presence - quantitative (#51) (Discussion link)

  • Added rules: result @value presence - qualitative (#52) (Discussion link)

Useful links

  • Contact
  • Privacy policy
  • Translation FAQs
  • Data removal

Newsletter

Copyright IATI 2023. All rights reserved

  • Twitter
  • YouTube