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

  • IATI Developer Documentation
  • (GitHub) Contributor Covenant Code of Conduct
  • Code of practice
  • Codelist API
  • Datastore and Data Pipelines
  • Design principles
  • Developer Community
  • Developer contributions
  • Guidance
  • IATI Normative and Non-normative content
  • IATI Software Deprecation Process
  • IATI Software Versioning Protocol
  • IATI Standard (Single Source of Truth)
  • IATI code examples
  • Non-functional Requirements
  • Notes about IATI Python Code
  • Open source tools: IATI GitHub
  • Security considerations
  • Useful XQuery queries
  • Guidance and support
  • IATI Developer Documentation
  • Developer contributions

Developer contributions

IATI is an open data standard and developers are encouraged to build tools that are open source, to allow for code contributions. IATI’s GitHub organisation account are the place to comment on IATI software, to raise a bug or to see what is happening at the code level with our various tools.

Raising issues

For bugs, feature requests, or other general enquiries about the IATI code base, we ask that appropriate issues are raised in the corresponding repository. Please follow templates provided to raise different types of issues, to help both the IATI Secretariat and other users to understand the context.

To make it clear what is currently a problem and being actively addressed, we only keep active issues open and will ask contributors to close issues that have been resolved or are not currently reproducible in the codebase.

Making pull requests

Pull requests must be made from forked versions of our repositories and should be made towards development branches of the repository when available. Branches must be clearly identified and given the number of the issue linked to it (i.e. 43-adding-button).

Please follow this guide if you wish to have your pull requests reviewed by the IATI Secretariat. This guide was created to ensure that contributions have a meaningful long-term impact on the IATI code base. It is also beneficial to open a GitHub issue about any significant features you may wish to add, as the IATI Secretariat reserves the right to reject pull requests that fall outside their scheduled work.

Contributions must follow the following conventions.

  • Human readable code - Write your code clearly with descriptive variable names. - Write your code so that any developer could read it. - You are contributing to a community – write your code for the members, as well as for yourself.

  • Robustly tested code - All core functionality is to be unit tested and edge cases considered. We strongly suggest that you use Test Driven Development. We also require details and evidence of any manual testing to show that no existing functionality is unexpectedly broken.

  • Documented code - We expect a clear docstring per module, class and function, explaining what it does at a minimum. This is to reduce both developer onboarding time and the barriers to entry for new developers who want to contribute.

  • General coding principles - Don’t Repeat Yourself: keep your code DRY. - Avoid excessive use of conditional statements; your functions should be doing the minimum possible for maximum effect. - Consider polymorphism and the single responsibility principle when viable. - KISS: keep it short and simple.

For detailed information about contributing to IATI tools maintained by the IATI Secretariat, please review the CONTRIBUTING.rst files for the repository you wish to work with.

Contributing to IATI tools managed by external vendors

For contributions to IATI tools that are not directly managed by the IATI Secretariat, please refer to the vendor’s contribution guidelines. These tools include d-portal.

Useful links

  • Privacy policy
  • Translation FAQs
  • Data removal

Newsletter

Copyright IATI 2025. All rights reserved

  • Twitter
  • YouTube