Organisation Identifiers¶
The IATI standard allows for the recording of information on all organisations that participate in any part of the lifecycle of an aid activity: inter alia donors, beneficiaries, extending and implementing agencies.
Crucial to this, is a common process through which to identify and declare identifiers for these organisations.
Introduction¶
Organisational identifiers have two uses in IATI.
In the IATI organisation standard:
They are used to identify organisations as reporting organisations (
reporting-org
), as receiving budgets (recipient-org
), and of course as aniati-organisation
.They form the
iati-identifier
- used to declare a globally unique identifier for the specificiati-organisation
In the IATI activity standard:
They are used to identify organisations as reporting organisations (
reporting-org
), receiving funds (receiver-org
), providing funds (provider-org
), or otherwise involved iniati-activities
(usingparticipating-org
)They form the basis of the
iati-identifier
- used to declare a globally unique activity identifier for the specificiati-activity
- composed of the reporting organisation Organisation ID, and an Activity ID.
Two components of IATI Organisation Identifiers¶
The two components of IATI Organisation Identifiers
The IATI Organisational Identifier scheme is based on re-using existing known identifiers for an organisation.
Identifier strings consist of two components:
The namespace code - a code that creates and maintains a given organisational identifier registry
The base identifier – re-use of an existing identifier from that namespace/registry
1 and 2 are separated by a dash -
.
The namespace code (1) may contain a dash -
.
Worked example¶
GB-COH
is the namespace code to the UK Companies Registrar which issues numerical company identifiers to legally constituted limited companies in the United Kingdom of Great Britain and Northern Ireland:
06368740
is the company number (base identifier) issued to Development Initiatives Poverty Research Limited.
Combining these we get an IATI Organisational Identifier of: GB-COH-06368740
Organisation Registration Agencies¶
To assist with creating and de-referencing IATI Organisation Identifiers, the codelist Organisation Registration Agency is available.
This codelist provides the namespace codes for a number of Registration Agencies. This list is non-embedded in the IATI Standard, which means changes and additions may be made at short notice, outside of published decimal and integer upgrade schedules. If a Registation Agency that you wish to use is not on this list, please contact support@iatistandard.org.
Guidance on selecting an Organisation Registration Agencies (namespace)¶
An IATI Organisation Identifier should:
Use an existing registration number/identifier that has been given to an organisation by an official registry of organisations (for example, a national company registrar, or drawn from a government register of charities). Registries that provide machine readable access to the data about organisations are generally preferred over those that do not (subject to (3) below).
Use a namespace/registry code from the existing IATI list of namespaces and registration agency codes. This is currently available as a codelist. If no existing code is available then you should contact IATI Support with details of the registration agency you wish to re-use a code from in order to have a code set up.
Where an organisation has multiple registration numbers, prefer those identifiers which uniquely pick out the organisation itself, rather than properties of the organisation. For example, a VAT/Tax registration number describes that an entity is registered for tax, but may not map directly onto a single legal entity – as – for example – groups of companies may share a VAT registration number. For this reason, an identifier such as
GB-COH-123456
would be preferred toGB-VAT-987765
.Where an organisation is not identified in an official national registry, but it is identified on the (deprecated since v1.04 of the standard) ``OrganisationIdentifier`` codelist, these codes should be used as given..
Where none of the above provide an appropriate identifier, third-parties may provide appropriate lists of organisations. Consult with IATI Support to identify appropriate identifier lists.
Where no other identifiers are held or available, please contact IATI support.
If you are unsure of which registration agency to prefer, please consult IATI Support. If no authoritative registration agency information is currently collected (e.g. internal identifiers and supplier numbers are recorded, but no external identifiers) IATI publishers are encouraged to identify opportunities to collect an authoritative public identifier.
Example Usage¶
Once determined, the IATI Organisational Identifier can be used:
IATI organisation standard: as the
iati-identifier
, in the@ref
attribute ofreporting-org
andrecipient-org-budget/recipient-org
.IATI activity standard: in the
@ref
attribute ofreporting-org
andparticipating-org
, and should be used in@ref
attribute oftransaction/provider-org
andtransaction/recipient-org
.
The string value name within any organisational identifier XML tag is provided for convenience of consuming applications only, and should not be treated as definitive.