recipient-org
=============

``iati-organisations/iati-organisation/recipient-org-budget/recipient-org``

This is the reference page for the XML element ``recipient-org``. 

.. index::
  single: recipient-org

Definition
~~~~~~~~~~


The organisation that will receive the funds.



Rules
~~~~~








This element must occur once and only once (within each parent element).








Attributes
~~~~~~~~~~


.. _iati-organisations/iati-organisation/recipient-org-budget/recipient-org/.ref:

@ref
  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.



  





Example Usage
~~~~~~~~~~~~~
Example usage of ``recipient-org`` in context of ``recipient-org-budget`` element:

| This example declares the organisation identifier with the ``@ref`` attribute.

.. literalinclude:: ../../../organisation-standard-example-annotated.xml
	:language: xml
	:start-after: <!--recipient-org-budget starts-->
	:end-before: <!--recipient-org-budget ends-->

Changelog
~~~~~~~~~
2.03
^^^^
| The definition of the ``@ref`` attribute was `updated <https://discuss.iatistandard.org/t/migration-of-organisationregistrationagency-codelist-to-org-id-guide-included-2-03/851>`__.

2.01
^^^^
| Freetext is no longer allowed with this element.  It should `now be declared <http://iatistandard.org/upgrades/integer-upgrade-to-2-01/2-01-changes/#narrative-new-elements>`__  with the new child ``narrative`` element.


Developer tools
~~~~~~~~~~~~~~~

Find the source of this documentation on github:

* `Schema <https://github.com/IATI/IATI-Schemas/blob/version-2.03/iati-organisations-schema.xsd#L255>`_
* `Extra Documentation <https://github.com/IATI/IATI-Extra-Documentation/blob/version-2.03/en/organisation-standard/iati-organisations/iati-organisation/recipient-org-budget/recipient-org.rst>`_


Subelements
~~~~~~~~~~~

.. toctree::
   :titlesonly:
   :maxdepth: 1

   recipient-org/narrative