This is the reference page for the XML element reporting-org. See also the relevant overview page: Type of Organisations


The organisation issuing the report. May be a primary source (reporting on its own activity as donor, implementing agency, etc) or a secondary source (reporting on the activities of another organisation).

Specifying the @ref attribute is mandatory. May contain the organisation name as content.

All activities in an activity xml file must contain the same @ref AND this @ref must be the same as the iati-identifier recorded in the registry publisher record of the account under which this file is published.


This element must occur once and only 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 RegistrationAgency code list and {RegistrationNumber } is a valid identifier issued by the {RegistrationAgency}

This attribute is required.

This value must be of type xsd:string.

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


The type of organisation issuing the report. See IATI codelist for values.

This attribute is required.

This value must be of type xsd:string.

This value must be on the OrganisationType codelist.


A flag indicating that the reporting organisation is a secondary publisher: publishing data for which it is not directly responsible. This flag must not be reported by primary source publishers

This value must be of type xsd:boolean.

Example Usage

Example reporting-org for an iati-organisation.

An example organisation @ref of AA-AAA-123456789 is declared.
The @type attribute declares a valid code (40) from the OrganisationType codelist.
The optional @secondary-publisher boolean is included, for illustration.
  <reporting-org ref="AA-AAA-123456789" type="40" secondary-reporter="0">
	  <narrative>Organisation name</narrative>
	  <narrative xml:lang="fr">Nom de l'organisme</narrative>	  



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


The @secondary-publisher attribute was introduced in 1.04.

Developer tools

Find the source of this documentation on github: