‘The Registry is your single point of access for links to IATI data’
What is the IATI Registry?
The IATI Registry is an index of all datafiles published through the International Aid Transparency Initiative (IATI). It does not contain the actual data, it only links to the published data, and to the metadata describing the contents of the files.
All organisations that publish to IATI have an account on the IATI Registry. If you are interested in how to publish data to IATI, see the Guidance and Support section.
Who is the Registry for?
The IATI Registry is primarily for data publishers. It is where they manage their organisation details and add links to their datafiles. However, it is also the place to find publisher contact details and with the necessary technical ability, it can be used to access raw datafiles via APIs.
You should be using the Registry if you are a user with technical expertise - say, a developer - who wants to access and import metadata and raw IATI datafiles. If you are not a technical user and simply want to search and view IATI data in a user-friendly way, please go to d-portal or find out about other tools at Tools and resources for data use.
IATI XML datafiles are in a machine-readable format that allows data to be exchanged between, and used by, a growing number of tools and applications.
What information can I find in the Registry?
The IATI Registry holds metadata about each organisation publishing to IATI and the files they’ve published in the IATI XML format. The files themselves are stored in different places across the web.
When you open the homepage of the Registry you can see the total number of organisations that have registered with IATI and have published at least one datafile. The number automatically changes as the number of publishers grows.
The Registry metadata also lets all data users see a list of all organisations who have published to IATI, along with who their IATI contact is, where their files are hosted and the date they first published.
The IATI Registry contains sections for:
- Publishers - you can see a full list of all organisations that publish IATI data, including each publisher’s name, IATI organisation identifier, organisation type and the number of datafiles that they have published. If you click on an individual publisher, you will be able to see a list of their organisation and activity files with some metadata about each file, such as when it was last updated.
- Data - you can search the Registry by publisher name, publisher country, organisation type and recipient country. These are the metadata fields publishers have filled in to describe their organisation and the data they publish. The results that you receive will give you links to the raw XML data files.
How to find a publisher’s contact details
Each IATI publisher should display an email address on the IATI Registry and may also include a link to their website. To find these details, click on the required publisher’s page and the email address will be displayed on the right of the screen under ‘Contact’. There should also be a link to their website which often provides more contact information for the organisation.
Some organisations also include a specific contact email address for each activity. This can be found in their XML file. A way to check is to find the specific activity on d-portal and then select ‘View source XML’ beneath the activity ‘Project title’. In the source XML you can use CTRL + F to search for the word ‘email’.
How do I get data from the IATI Registry?
The IATI Registry is your single point of access for links to IATI data. You can access individual datasets using our built-in tools. More technically adept users can utilise our Registry API to access the metadata, including the URL for each published IATI file.
Accessing individual datasets
As well as letting you download individual XML files, the IATI Registry links to two data access tools. These are maintained by the IATI technical team.
When you are looking at the links to a IATI data file on a publisher’s page, you are given four options:
- View Metadata: This allows you to view the additional information about the file, such as the file type, recipient country for the file’s activities and when it was last updated.
- Download: This will download the raw XML file.
- The Preview Tool: This allows you to quickly preview an IATI publisher’s data by presenting it in an easy-to-read format. It lists each top-level element on a seperate line, and allows you to expand the section to see the data it contains.
- The CSV conversion tool: This allows you to convert individual IATI activity files from XML into CSV format. You can do that by selecting one of three options. You can then download the CSV file to use the data for the organisation you have selected.
- Simple activity summary (CSV)
- Full activity data (CSV)
- All transactions (CSV)
Using the Registry metadata API
You can use an API to access all the metadata held on the Registry. The API returns data in JSON format. The Registry API is an implementation of the CKAN API - see the full CKAN API documentation. The URL to each published file is included as metadata on the IATI Registry. Once you have a list of the relevant URLs you can set up the process to import the raw IATI data.
To fetch organisation file metadata:
To fetch activity file metadata:
These fetch calls will not return all results by default. You will need to select how many results you want to view by changing the offset and limit parameters. For example:
To fetch an individual dataset metadata use its identifier. Full dataset details contain information on downloadable resources (i.e. the IATI XML files)
The downloadable file details can be found in the resource.url field of the JSON response.
You can filter the responses on the basis of country (by ISO 2-digit code) or publisher (known as ‘organisations’ internally in the registry).
For example, to fetch all the activity file metadata from the UK Department for International Development (DFID) use:
To fetch all activity file metadata that has Ghana as its primary segment, use:
API for XML data
IATI offers several APIs. If you need an API to work directly with the IATI XML data, you can use the Data API with the IATI Datastore.
Who maintains the Registry?
The IATI Secretariat is responsible for the maintenance of the IATI Registry and works directly with Derilinx, a leading provider of CKAN development and hosting, who supply and manage the Registry.
If you have any questions or notice any issues, contact the IATI technical team.