This is version 2.01 of the IATI Standard. See other versions.
A new version (v2.02) became live in December 2015.

Organisation Standard Summary TableΒΆ

Section Item Description Type Codelist XML Occur Rules
iati-organisations   Top-level list of one or more IATI organisation records.     iati-organisations  
  version A number indicating the IATI specification version in use. This is mandatory and must be a valid version. xsd:string Version iati-organisations/@version 1..1  
  generated-datetime 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. xsd:dateTime   iati-organisations/@generated-datetime 0..1  
iati-organisation   Top-level element for a single IATI organisation report.     iati-organisations/iati-organisation 1..*  
  last-updated-datetime The last date/time that the data for this specific organisation was updated. This date must change whenever the value of any field changes. xsd:dateTime   iati-organisations/iati-organisation/@last-updated-datetime 0..1  
  xml:lang ISO 639-1 code specifying the default language used in narrative elements throughout the activity. If this is not declared then the xml:lang attribute MUST be specified for each narrative element.   Language iati-organisations/iati-organisation/@xml:lang 0..1  
  default-currency 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. xsd:string Currency iati-organisations/iati-organisation/@default-currency 0..1  
organisation-identifier   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}     iati-organisations/iati-organisation/organisation-identifier 1..1 organisation-identifier should match the regex [^\/\&\|\?]+
name   The human-readable name of the organisation.     iati-organisations/iati-organisation/name 1..1  
  narrative The free text name or description of the item being described. This can be repeated in multiple languages.     iati-organisations/iati-organisation/name/narrative 1..*  
      xsd:string   iati-organisations/iati-organisation/name/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/name/narrative/@xml:lang 0..1  
reporting-org  

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.

    iati-organisations/iati-organisation/reporting-org 1..1  
  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 RegistrationAgency code list and {RegistrationNumber } is a valid identifier issued by the {RegistrationAgency} xsd:string   iati-organisations/iati-organisation/reporting-org/@ref 1..1 reporting-org/@ref should match the regex [^\/\&\|\?]+
  type The type of organisation issuing the report. See IATI codelist for values. xsd:string Organisation Type iati-organisations/iati-organisation/reporting-org/@type 1..1  
  secondary-reporter 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 xsd:boolean   iati-organisations/iati-organisation/reporting-org/@secondary-reporter 0..1  
  narrative The name of the organisation. May be repeated for different languages.     iati-organisations/iati-organisation/reporting-org/narrative 1..*  
      xsd:string   iati-organisations/iati-organisation/reporting-org/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/reporting-org/narrative/@xml:lang 0..1  
total-budget   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.     iati-organisations/iati-organisation/total-budget 0..*  
  period-start The start of the budget period.     iati-organisations/iati-organisation/total-budget/period-start 1..1  
  iso-date   xsd:date   iati-organisations/iati-organisation/total-budget/period-start/@iso-date 1..1 period-start/@iso-date must be before period-end/@iso-date
  period-end The end of the period (which must not be greater than one year)     iati-organisations/iati-organisation/total-budget/period-end 1..1  
  iso-date   xsd:date   iati-organisations/iati-organisation/total-budget/period-end/@iso-date 1..1 period-start/@iso-date must be before period-end/@iso-date
  value The total value of the organisation’s aid budget for this period.     iati-organisations/iati-organisation/total-budget/value 1..1  
  currency A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-organisation/@default-currency attribute is specified. xsd:string Currency iati-organisations/iati-organisation/total-budget/value/@currency 0..1  
  value-date The date to be used for determining the exchange rate for currency conversions. xsd:date   iati-organisations/iati-organisation/total-budget/value/@value-date 0..1  
  budget-line 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.     iati-organisations/iati-organisation/total-budget/budget-line 0..*  
  ref An internal reference for this budget line taken from the reporting organisation’s own system. Optional. xsd:string   iati-organisations/iati-organisation/total-budget/budget-line/@ref 0..1  
  value The budget sub-total. The definition of the sub-division is determined by iati-organisation/total-budget/budget-line/narrative     iati-organisations/iati-organisation/total-budget/budget-line/value 1..1  
  currency A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-organisation/@default-currency attribute is specified. xsd:string   iati-organisations/iati-organisation/total-budget/budget-line/value/@currency 0..1  
  value-date The date to be used for determining the exchange rate for currency conversions. xsd:date   iati-organisations/iati-organisation/total-budget/budget-line/value/@value-date 0..1  
  narrative The free text name or description of the item being described. This can be repeated in multiple languages.     iati-organisations/iati-organisation/total-budget/budget-line/narrative 1..*  
      xsd:string   iati-organisations/iati-organisation/total-budget/budget-line/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/total-budget/budget-line/narrative/@xml:lang 0..1  
recipient-org-budget   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.     iati-organisations/iati-organisation/recipient-org-budget 0..*  
  recipient-org The organisation that will receive the funds.     iati-organisations/iati-organisation/recipient-org-budget/recipient-org 1..1  
  ref Machine-readable identification string for the organisation. Must be in the format {Registration Agency} - (Registration Number} where {Registration Agency} is a valid code in the Registration Agency code list and {Registration Number } is a valid identifier issued by the {Registration Agency}. If this is not present then the narrative MUST contain the name of the organisation. xsd:string   iati-organisations/iati-organisation/recipient-org-budget/recipient-org/@ref 0..1  
  narrative The name of the organisation. This can be repeated in multiple languages.     iati-organisations/iati-organisation/recipient-org-budget/recipient-org/narrative 1..*  
      xsd:string   iati-organisations/iati-organisation/recipient-org-budget/recipient-org/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/recipient-org-budget/recipient-org/narrative/@xml:lang 0..1  
  period-start The start of the budget period.     iati-organisations/iati-organisation/recipient-org-budget/period-start 1..1  
  iso-date   xsd:date   iati-organisations/iati-organisation/recipient-org-budget/period-start/@iso-date 1..1 period-start/@iso-date must be before period-end/@iso-date
  period-end The end of the period (which must not be greater than one year)     iati-organisations/iati-organisation/recipient-org-budget/period-end 1..1  
  iso-date   xsd:date   iati-organisations/iati-organisation/recipient-org-budget/period-end/@iso-date 1..1 period-start/@iso-date must be before period-end/@iso-date
  value The total value of the money budgeted to be disbursed to the specified recipient organisation during this time period.     iati-organisations/iati-organisation/recipient-org-budget/value 1..1  
  currency A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-organisation/@default-currency attribute is specified. xsd:string Currency iati-organisations/iati-organisation/recipient-org-budget/value/@currency 0..1  
  value-date The date to be used for determining the exchange rate for currency conversions. xsd:date   iati-organisations/iati-organisation/recipient-org-budget/value/@value-date 0..1  
  budget-line 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.     iati-organisations/iati-organisation/recipient-org-budget/budget-line 0..*  
  ref An internal reference for this budget line taken from the reporting organisation’s own system. Optional. xsd:string   iati-organisations/iati-organisation/recipient-org-budget/budget-line/@ref 0..1  
  value The budget sub-total. The definition of the sub-division is determined by iati-organisation/recipient-org-budget/budget-line/narrative     iati-organisations/iati-organisation/recipient-org-budget/budget-line/value 1..1  
  currency A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-organisation/@default-currency attribute is specified. xsd:string   iati-organisations/iati-organisation/recipient-org-budget/budget-line/value/@currency 0..1  
  value-date The date to be used for determining the exchange rate for currency conversions. xsd:date   iati-organisations/iati-organisation/recipient-org-budget/budget-line/value/@value-date 0..1  
  narrative The free text name or description of the item being described. This can be repeated in multiple languages.     iati-organisations/iati-organisation/recipient-org-budget/budget-line/narrative 1..*  
      xsd:string   iati-organisations/iati-organisation/recipient-org-budget/budget-line/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/recipient-org-budget/budget-line/narrative/@xml:lang 0..1  
recipient-country-budget   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.     iati-organisations/iati-organisation/recipient-country-budget 0..*  
  recipient-country The recipient country.     iati-organisations/iati-organisation/recipient-country-budget/recipient-country 1..1  
  code ISO 3166-1 alpha-2 code for the country. xsd:string Country iati-organisations/iati-organisation/recipient-country-budget/recipient-country/@code 1..1  
  narrative The free text name or description of the item being described. This can be repeated in multiple languages.     iati-organisations/iati-organisation/recipient-country-budget/recipient-country/narrative 0..*  
      xsd:string   iati-organisations/iati-organisation/recipient-country-budget/recipient-country/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/recipient-country-budget/recipient-country/narrative/@xml:lang 0..1  
  period-start The start of the budget period.     iati-organisations/iati-organisation/recipient-country-budget/period-start 1..1  
  iso-date   xsd:date   iati-organisations/iati-organisation/recipient-country-budget/period-start/@iso-date 1..1 period-start/@iso-date must be before period-end/@iso-date
  period-end The end of the period (which must not be greater than one year)     iati-organisations/iati-organisation/recipient-country-budget/period-end 1..1  
  iso-date   xsd:date   iati-organisations/iati-organisation/recipient-country-budget/period-end/@iso-date 1..1 period-start/@iso-date must be before period-end/@iso-date
  value The total value of the money budgeted to be disbursed to the specified country during this time period. This element is required.     iati-organisations/iati-organisation/recipient-country-budget/value 1..1  
  currency A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-organisation/@default-currency attribute is specified. xsd:string Currency iati-organisations/iati-organisation/recipient-country-budget/value/@currency 0..1  
  value-date The date to be used for determining the exchange rate for currency conversions. xsd:date   iati-organisations/iati-organisation/recipient-country-budget/value/@value-date 0..1  
  budget-line 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.     iati-organisations/iati-organisation/recipient-country-budget/budget-line 0..*  
  ref An internal reference for this budget line taken from the reporting organisation’s own system. Optional. xsd:string   iati-organisations/iati-organisation/recipient-country-budget/budget-line/@ref 0..1  
  value The budget sub-total. The definition of the sub-division is determined by iati-organisation/recipient-country-budget/budget-line/narrative     iati-organisations/iati-organisation/recipient-country-budget/budget-line/value 1..1  
  currency A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-organisation/@default-currency attribute is specified. xsd:string   iati-organisations/iati-organisation/recipient-country-budget/budget-line/value/@currency 0..1  
  value-date The date to be used for determining the exchange rate for currency conversions. xsd:date   iati-organisations/iati-organisation/recipient-country-budget/budget-line/value/@value-date 0..1  
  narrative The free text name or description of the item being described. This can be repeated in multiple languages.     iati-organisations/iati-organisation/recipient-country-budget/budget-line/narrative 1..*  
      xsd:string   iati-organisations/iati-organisation/recipient-country-budget/budget-line/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/recipient-country-budget/budget-line/narrative/@xml:lang 0..1  
document-link   A link to an online, publicly accessible web page or document.     iati-organisations/iati-organisation/document-link 0..*  
  url The target URL of the external document, e.g. “http://www.example.org/doc.odt”. xsd:anyURI   iati-organisations/iati-organisation/document-link/@url 1..1  
  format An IANA code for the MIME type of the document being referenced, e.g. “application/pdf”. xsd:string File Format iati-organisations/iati-organisation/document-link/@format 1..1  
  title A short, human-readable title.     iati-organisations/iati-organisation/document-link/title 1..1  
  narrative The free text name or description of the item being described. This can be repeated in multiple languages.     iati-organisations/iati-organisation/document-link/title/narrative 1..*  
      xsd:string   iati-organisations/iati-organisation/document-link/title/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/document-link/title/narrative/@xml:lang 0..1  
  category IATI Document Category Code     iati-organisations/iati-organisation/document-link/category 1..*  
  code An IATI code defining the category of the document. xsd:string Document Category iati-organisations/iati-organisation/document-link/category/@code 1..1  
  language The ISO 639-1 language code in which target document is written, e.g. “en”. Can be repeated to describe multi-lingual documents.     iati-organisations/iati-organisation/document-link/language 0..*  
  code ISO 639-1 language code xsd:string Language iati-organisations/iati-organisation/document-link/language/@code 1..1  
  recipient-country The recipient country that is the focus of the document. May be repeated for multiple countries.     iati-organisations/iati-organisation/document-link/recipient-country 0..*  
  code ISO 3166-1 alpha-2 code for the country. xsd:string Country iati-organisations/iati-organisation/document-link/recipient-country/@code 1..1  
  narrative The free text name or description of the item being described. This can be repeated in multiple languages.     iati-organisations/iati-organisation/document-link/recipient-country/narrative 0..*  
      xsd:string   iati-organisations/iati-organisation/document-link/recipient-country/narrative/text()    
  xml:lang ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.   Language iati-organisations/iati-organisation/document-link/recipient-country/narrative/@xml:lang 0..1  
International Aid Transparency Initiative: Organisation-Information Schema

Release 2.01, 2014-10-21

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.

Last updated on 2015-01-21