recipient-region

Definition

A supranational geopolitical region that will benefit from this activity. For sub-national 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. Recipient-region must not be used merely to describe the region of a country reported in recipient-country, but ONLY if the region is a recipient IN ADDITION to the country.

Region can also be reported at transaction rather than activity level. If transaction/recipient-country AND/OR transaction/recipient-region are used THEN ALL transaction elements MUST contain a recipient-country and/or recipient-region element AND iati-activity/recipient-region and iati-activity/recipient-region MUST NOT be used AND each transaction MUST only contain one recipient-country or recipient-region.

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.1: When multiple recipient countries or regions are declared, each must have a percentage.

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

Either an OECD DAC or UN region code. Codelist is determined by vocabulary attribute.

This attribute is required.

This value must be of type xsd:string.

This value must be on the Region codelist, if the relevant vocabulary is used.

@vocabulary

An IATI code for the vocabulary from which the region code is drawn. If it is not present 1 - ‘OECD DAC’ is assumed.

This value must be of type xsd:string.

This value must be on the RegionVocabulary codelist.

@vocabulary-uri

The URI where this vocabulary is defined. If the vocabulary is 99 (reporting organisation), the URI where this internal vocabulary is defined. While this is an optional field it is STRONGLY RECOMMENDED that all publishers use it to ensure that the meaning of their codes are fully understood by data users.

This value must be of type xsd:anyURI.

@percentage

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

This value must be of type xsd:decimal.

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

12.1.1: The country/region percentage value must be between 0.0 and 100.0 (inclusive).

Example Usage

Example recipient-region of an iati-activity.

The @code attribute declares a valid code (489) from the Region codelist.

The optional @vocabulary attribute declares a valid code (1) from the RegionVocabulary codelist.

<recipient-region code="489" vocabulary="1" />

If a publisher uses a vocabulary of 99 (i.e. ‘Reporting Organisation’), then the @vocabulary-uri attribute should also be used, for example:

<recipient-region code="A1" vocabulary="99" vocabulary-uri="http://example.com/vocab.html" />

Please note, if using your own vocabulary (i.e. code 99), it is recommended that this is used in addition to the DAC OECD region vocabulary (code 1).

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

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

<recipient-region code="489" vocabulary="1" percentage="50" />
<recipient-region code="389" vocabulary="1" 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" />
<recipient-region code="A1" vocabulary="99" percentage="50" vocabulary-uri="http://example.com/vocab.html" />

Changelog

Developer tools

Find the source of this documentation on github:

• Schema

• Extra Documentation

Subelements

• narrative