This is the reference page for the XML element receiver-org.


The organisation receiving the money from the transaction (if omitted on incoming funds then the receiver organisation is assumed to be the reporting organisation).


This element must occur no more than once (within each parent element).



Machine-readable identification string for the organisation issuing the report. Must be in the format {RegistrationAgency}-{RegistrationNumber} where {RegistrationAgency} is a valid code in the Organisation Registration Agency code list and {RegistrationNumber} is a valid identifier issued by the {RegistrationAgency}. If this is not present then the narrative MUST contain the name of the organisation.

This value must be of type xsd:string.

transaction/receiver-org/@ref should match the regex [^\/\&\|\?]+

Either @ref or narrative must be present.


If outgoing funds are being provided to another activity that is reported to IATI, this may, if possible, record the unique IATI activity identifier for that activity.

This value must be of type xsd:string.


The type of organisation receiving the funds.

This value must be of type xsd:string.

This value must be on the OrganisationType codelist.

Example Usage

Example usage of receiver-org of a transaction in an iati-activity.

This example declares the organisation identifier with the @ref attribute.
This example declares the type of organisation receiving the funds, using the @type attribute.
<receiver-org ref="AA-AAA-123456789" type="23">
  <narrative>Agency B</narrative>
This example additionally declares the unique iati-identifier of the reported iati-activity to where the transaction is received, with the @receiver-activity-id attribute.
<receiver-org ref="AA-AAA-123456789" type="23" receiver-activity-id="AA-AAA-123456789-1234">
  <narrative>Agency A</narrative>

Full example, within a transaction.

  <transaction ref="1234" humanitarian="1">
   <transaction-type code="1" />
   <transaction-date iso-date="2012-01-01" />
   <value currency="EUR" value-date="2012-01-01">1000</value>
    <narrative>Transaction description text</narrative>
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" type="10" ref="BB-BBB-123456789">
    <narrative>Agency B</narrative>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" type="23" ref="AA-AAA-123456789">
    <narrative>Agency A</narrative>
   <disbursement-channel code="1" />
   <sector vocabulary="2" code="111" />
   <!--Note: only a recipient-region OR a recipient-country is expected-->
   <recipient-country code="TM" />
   <recipient-region code="616" vocabulary="1" />
   <flow-type code="10" />
   <finance-type code="110" />
   <aid-type code="A01" vocabulary="1" />
   <aid-type code="1" vocabulary="2" />
   <tied-status code="3" />



The definition of the @ref attribute was updated.


The attribute @type was added.


Freetext is no longer allowed with this element. It should now be declared with the new child narrative element.

Developer tools

Find the source of this documentation on github: