International Aid Transparency Initiative: Organisation-Information Schema
Release 2.03, 2018-02-19
NOTE: the xml.xsd and iati-common.xsd schemas must be in the
same directory as this one.
This W3C XML Schema defines an XML document type for information
about an aid organisation, following the standard published at
http://iatistandard.org
This document type may be extended with additional elements and
attributes, but they must belong to an explicit XML namespace.
Top-level list of one or more IATI organisation records.
A number indicating the IATI specification version in use.
This is mandatory and must be a valid version.
A date/time stamp for when this file was generated. This
is not necessarily the last-updated date for the
individual activity records in it. Use of this attribute
is highly recommended, to allow recipients to know when a
file has been updated.
Top-level element for a single IATI organisation report.
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}.
The last date/time that the data for this specific
organisation was updated. This date must change whenever
the value of any field changes.
A code specifying the default language of text in this organisation. It is recommended that wherever possible only codes from ISO 639-1 are used. If this is not declared then the xml:lang attribute MUST be specified for each narrative element.
Default ISO 4217 currency code for all financial values in
this activity report. If this is not declared then the
currency attribute MUST be specified for all monetary
values.
The human-readable name of the organisation.
The total-budget element allows for the reporting of the organisation's
own budget. The recommendation is that, where and when possible, the
organisation's total annual planned budget for each of the next three
years is reported. The status explains whether the budget being reported
is indicative or has been formally committed. The value should appear
within the BudgetStatus codelist. If the @status attribute is not present,
the budget is assumed to be indicative.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the organisation's aid budget for
this period.
A breakdown of the total budget into sub-totals. The
breakdown is determined by the reporting organisation
and described in the narrative. The period covered is
the same as that covered by the parent total-budget
element. The sum of budget-line values does not have to
equal the value given in the parent element.
The budget sub-total. The definition of the
sub-division is determined by
iati-organisation/total-budget/budget-line/narrative
An internal reference for this budget line taken
from the reporting organisation's own system.
Optional.
The status explains whether the budget being reported is indicative or has
been formally committed. The value should appear within the BudgetStatus
codelist. If the @status attribute is not present, the budget is assumed
to be indicative.
The recipient-org-budget element allows for the reporting of
forward looking budgets for each institution which receives
core funding from the reporting organisation. The
recommendation is that, where and when possible, annual
planned budgets for each recipient institution for each of the
next three financial years are reported. This is primarily
applicable to donors but any provider of core funding is
expected to use it. Earmarked budgets should be reported at
activity-level through the Activity Standard. The status
explains whether the budget being reported is indicative or
has been formally committed. The value should appear within
the BudgetStatus codelist. If the @status attribute is not
present, the budget is assumed to be indicative.
The organisation that will receive the funds.
The name of the organisation. This can be repeated in multiple languages.
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.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the money budgeted to be disbursed to
the specified recipient organisation during this time
period.
A breakdown of the recipient organisation's budget into
sub-totals. The breakdown is determined by the
reporting organisation and described in the narrative.
The period covered is the same as that covered by the
parent recipient-org-budget element. The sum of
budget-line values does not have to equal the value
given in the parent element.
The budget sub-total. The definition of the
sub-division is determined by
iati-organisation/recipient-org-budget/budget-line/narrative
An internal reference for this budget line taken
from the reporting organisation's own system.
Optional.
The status explains whether the budget being reported is indicative or has
been formally committed. The value should appear within the BudgetStatus
codelist. If the @status attribute is not present, the budget is assumed
to be indicative.
The recipient-region-budget element allows for the reporting of forward
looking budgets where the organisation maintains region-wide, rather than
or in addition to country-specific budgets. The recommendation is that,
where and when possible, the organisation’s total annual planned budget
for each of the next three financial years is reported for each recipient
region. This must NOT include an aggregation of budgets reported in the
recipient-country-budget element. It is strongly recommended that
publishers report to existing defined regions wherever possible. The
status explains whether the budget being reported is indicative or has
been formally committed. The value should appear within the BudgetStatus
codelist. If the @status attribute is not present, the budget is assumed
to be indicative.
The supranational geographic region where funds have been allocated.
An IATI code for the vocabulary from which the region code is
drawn. If it is not present, code 1 ('OECD DAC') is assumed.
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.
Either an OECD DAC, UN region code or (if code ‘99’ Reporting
organisation is selected for recipient-region/\@vocabulary) a
code from your internal vocabulary. The codelist is determined
by vocabulary attribute. The value in recipient-region/\@code
should appear within the Region codelist, if the vocabulary
code 1 ('OECD DAC') is used.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the money budgeted to be disbursed to
the specified region during this time period. This
element is required.
A breakdown of the recipient region’s budget into sub-totals. The
breakdown is determined by the reporting organisation and described
in the narrative. The period covered is the same as that covered by
the parent recipient-region-budget element. The sum of budget-line
values does not have to equal the value given in the parent element.
The budget sub-total. The definition of the
sub-division is determined by
iati-organisation/recipient-region-budget/budget-line/narrative
An internal reference for this budget line taken
from the reporting organisation's own system.
Optional.
The status explains whether the budget being reported is indicative or has
been formally committed. The value should appear within the BudgetStatus
codelist. If the @status attribute is not present, the budget is assumed
to be indicative.
The recipient-country-budget element allows for the reporting of
forward looking budgets for each country in which the organisation
operates. The recommendation is that, where and when possible, the
organisation's total annual planned budget for each of the next
three financial years is reported for each recipient country.
It is strongly recommended that the start and end of the reported
financial years match those of the recipient country's
budgetary/planning cycle. The status explains whether the budget
being reported is indicative or has been formally committed. The
value should appear within the BudgetStatus codelist. If the
@status attribute is not present, the budget is assumed to be
indicative.
The recipient country.
ISO 3166-1 alpha-2 code for the country.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the money budgeted to be disbursed to
the specified country during this time period. This
element is required.
A breakdown of the recipient country's budget into
sub-totals. The breakdown is determined by the
reporting organisation and described in the narrative.
The period covered is the same as that covered by the
parent recipient-country-budget element. The sum of
budget-line values does not have to equal the value
given in the parent element.
The budget sub-total. The definition of the
sub-division is determined by
iati-organisation/recipient-country-budget/budget-line/narrative
An internal reference for this budget line taken
from the reporting organisation's own system.
Optional.
The status explains whether the budget being reported is indicative or has
been formally committed. The value should appear within the BudgetStatus
codelist. If the @status attribute is not present, the budget is assumed
to be indicative.
The total-expenditure element allows for the reporting of the
organisation’s international development expenditure. The
recommendation is that, where and when possible, the organisation’s
total expenditure for each of the past three years is reported.
The expense line allows publishers to record further breakdown.
The start of the budget period.
The end of the period (which must not be greater than one year)
The total value of the organisation's aid expenditure for
this period.
A breakdown of the total expenditure into sub-totals.
The breakdown is determined by the reporting
organisation and described in the narrative. The period
covered is the same as that covered by the parent
total-expenditure element. The sum of expenditure-line
values does not have to equal the value given in the
parent element.
The expenditure sub-total. The definition of the
sub-division is determined by
iati-organisation/total-expenditure/expenditure-line/narrative
An internal reference for this expenditure line taken
from the reporting organisation’s own system. Optional.
A link to an online, publicly accessible web page or document.
The recipient country that is the focus of the document.
May be repeated for multiple countries.
ISO 3166-1 alpha-2 code for the country.