Countries & Regions
This page is currently flagged for review. We are undertaking an update of the information we publish about the IATI Standard, and the content here has not yet been checked.
When a national government (for example) wants to know how much aid money is being spent in its country, it can read the jurisdictional markup. The most common element for jurisdictional information is recipient-country, as in the following example:
This example specifies that Haiti is the sole partner country for this aid activity. The value of the code attribute is an ISO 3166-1 alpha2 country code (see the IATI Country code list); while the code attribute is not required by the schema, it is strongly recommended to aid in machine processing. The country name is optional, and appears as the element’s content (the xml:lang attribute is allowed to specify the language of the name).
Some activities have more than one partner country; in that case, the activity report will list all of the countries, with the percentage attribute available to specify the percentage of the total budget allocated to each country (if known):
<recipient-country code=”GH” percentage=”40”>Ghana</recipient-country>
<recipient-country code=”BF” percentage=”30”>Burkina Faso</recipient-country>
<recipient-country code=”CI” percentage=”30”>Côte d’Ivoire</recipient-country>
Some activities, in their early stages, may be intended for a general geographical region such as the Middle East or West Indieis, without having (yet) selected specific partner countries. In that case, the recipient-region element allows specifying a broader geographical region:
<recipient-region code=”380”>West Indies</recipient-region>
As with recipient-country, the element may repeated for multiple regions, with an optional percentage attribute:
<recipient-region code=”380” percentage=”50”>West Indies</recipient-region>
<recipient-region code=”489” percentage=”50”>South America</recipient-region>
For recipient-region, IATI uses regional codes defined by the OECD’s Development Assistance Committee (DAC). These codes appear in the IATI Region code list.