New IATI Datastore API launched for testing

  • Aug. 19, 2019

IATI’s new Datastore API is being launched for a month of public testing between 19 August and 18 September, as announced in the IATI technical team’s last quarterly update.

The technical team and Zimmerman and Zimmerman, who are building the new Datastore, are calling on technical users to test the Datastore API and provide feedback.

About the new Datastore

The new IATI Datastore aims to offer a robust online data service, providing timely and standardised access to data published according to the IATI Standard. Initially, users can gain data on development and humanitarian resources and results through using the Datastore’s API. Users will also be able to download data from a new user-friendly Datastore Query Builder, which is due to be released shortly for testing.

What data can be accessed?

The new IATI Datastore API provides data published by organisations who have used version 2 of the IATI Standard. This is following the decision to deprecate version 1 by IATI members, which was implemented last month.

To help users access good quality data, the Datastore will not hold any data that does not adhere to the IATI Schema. The IATI Schema provides the exact order and format that publishers should provide their XML files in. More information about the Schema can be found on IATI’s Reference site.

Testing the new Datastore API (19 Aug - 18 Sept)

Users are invited to test the new API to build queries of selected IATI data and review the output of data from the Datastore. Specifically users are requested to:

  • check that they can filter the data by the elements/parameters they require;
  • review the content of the data that is returned to ensure it accurately matches the elements/parameters selected and,
  • check that the output they receive is useable and matches their expectations.

When testing, please refer to the Datastore API documentation and IATI Datastore – API mapping and examples, then provide your feedback on Github on the IATI Datastore project. This will help the technical team and Zimmerman and Zimmerman more easily review feedback and, where applicable, convert issues directly into GitHub tickets to work on.

What will happen after the Datastore testing phase?

After the testing deadline of 18 September, the technical team and Zimmerman and Zimmerman will post an update about the collected feedback on IATI Discuss. They will also contact users individually if more information is needed, continue triaging issues and action changes where required.

Based on the scope of the testing phase and its follow-up weeks, a date for the official launch of the Datastore will be set and the old Datastore will be phased out 6 months after this date.

Help to transition from using the old datastore to the new IATI Datastore

The technical team will be working to ensure that users can smoothly transition from using the old datastore to using the new IATI Datastore. They will:

  • provide a mapping document with some examples to help testing and migrating between Datastore versions
  • provide automated redirects from old to new datastore API calls for 6 months
  • publish API documentation and a User Manual
  • offer direct support from the technical team via email or one-to-one calls.

Thanks in advance to IATI’s dedicated community who are able to support the testing phase of the Datastore. The technical team and Zimmerman and Zimmerman look forward to receiving your feedback. For any questions please email: [email protected].