You are viewing VERSION 2.01 of IATI Standard Reference View another version

recipient-country

iati-activities/iati-activity/recipient-country

This is the reference page for the XML element recipient-country.

Definition

A country that will benefit from this activity. If a specific country is not known the recipient-region element should be used instead. For geographical location, use the location element.

Multiple countries and regions can be reported, in which case the percentage attribute MUST be used to specify the share of total commitments across all reported countries and regions.

The country can also be specified at transaction rather than activity level. If recipient-country OR recipient-region are reported at the transaction level, ALL transactions MUST contain a recipient-country or recipient-region element and iati-activity/recipient-country and iati-activity/recipient-region MUST NOT be used.

Rules

This element may occur any number of times.

3.1.1: When multiple recipient countries are declared, each must have a percentage.

3.1.4: When a single recipient country is declared, the percentage must either be omitted, or set to 100.

3.4.4: When a single recipient region in a vocabulary is declared, the percentage must either be omitted, or set to 100.

3.6.2: Recipient countries or regions must only be declared at activity level OR for all transactions.

3.7.1: Recipient country or recipient region should be declared for either the activity or for all transactions.

3.7.2: Recipient country or recipient region should be declared for either the activity or for all transactions.

Attributes

@code

ISO 3166-1 alpha-2 code for the country.

This attribute is required.

This value must be of type xsd:string.

This value should be on the Country codelist.

@percentage

The percentage of total commitments or total activity budget allocated to this country. Content must be a positive decimal number between 0 and 100, with no percentage sign. Percentages for all reported countries and regions MUST add up to 100%

This value must be of type xsd:decimal.

3.1.2: Percentage values for recipient countries, must add up to 100%.

3.4.2: Percentage values for recipient countries or regions, must add up to 100%.

12.1.2: The country percentage value must be 0.0 or positive.

Example Usage

Example recipient-country of an iati-activity.

The @code attribute declares a valid code (AF) from the Country codelist.

<recipient-country code="AF" />

The recipient-country element can be repeated in any iati-activity.

When multiple recipient-country are declared, then the @percentage values should sum to 100% for the specific iati-activity:

<recipient-country code="AF" percentage="50" />
<recipient-country code="AG" percentage="50" />

When both the recipient-region and recipient-country are declared, then the @percentage values should sum to 100% per region vocabulary for the specific iati-activity.

<recipient-country code="AF" percentage="50" />
<recipient-region code="489" vocabulary="1" percentage="50" />

Changelog

2.01

Freetext is no longer allowed with this element. It should now be declared with the new child narrative element, but only in particular use-cases.

1.03

Where used, the @percentage attribute is now designated as a decimal value and no longer as a positive Integer

Developer tools

Find the source of this documentation on github:

Subelements