This is version 1.05 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
iati-organisations   Top-level list of one or more IATI organisation records.     iati-organisations  
  version A number indicating the IATI specification version in use. xsd:decimal   iati-organisations/@version 0..1
  generated-datetime A date/time stamp for when this file was generated. This is not necessarily the last-updated date for the individual organisation records in it. Uses ISO 8601 date format, e.g. “2010-03-12T18:45:00+01:00”. 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  
  version A number indicating the IATI specification version in use. Defaults to “1.0” if not specified. It is required to specify this attribute if the document is using features specific to an IATI specification other than the initial 1.0 version. xsd:decimal   iati-organisations/iati-organisation/@version 0..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 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/@xml:lang 0..1
  default-currency Default ISO 4217 currency code for all financial values in this organisation report. xsd:string Currency iati-organisations/iati-organisation/@default-currency 0..1
iati-identifier  

The iati-identifier element is used in both Activity files and Organisation files, and has a slightly different meaning depending on where it is being used, and should not be confused.

When used in an organisation it is a globally unique identifier for that organisation.

When used in an activity it is a globally unique identifier for that activity. This should be in the form of the IATI Organisation Identifier (for the reporting organisation) concatenated to that organisation’s activity identifier. (NB. Two or more reporting organisations may publish information on the same activity.)

    iati-organisations/iati-organisation/iati-identifier  
      mixed   iati-organisations/iati-organisation/iati-identifier/text()  
name   The human-readable name of the organisation. This element may be repeated to provide the name in different languages (using @xml:lang to distinguish).     iati-organisations/iati-organisation/name  
      mixed   iati-organisations/iati-organisation/name/text()  
  xml:lang ISO 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/name/@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  
      mixed   iati-organisations/iati-organisation/reporting-org/text()  
  ref Machine-readable identification string for the business object being described. xsd:string   iati-organisations/iati-organisation/reporting-org/@ref 0..1
  type A machine readable code describing the type of thing being referenced. The value should be available on a related codelist. xsd:string Organisation Type iati-organisations/iati-organisation/reporting-org/@type 0..1
  secondary-reporter If an activity is being published by a secondary publisher you may indicate this here. Use 1 for true, 0 for false. xsd:boolean   iati-organisations/iati-organisation/reporting-org/@secondary-reporter 0..1
  xml:lang ISO 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/reporting-org/@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  
  period-start The starting date for the budget period, in ISO 8601 format (e.g. 2010-04-01 for 1 April 2010). This element must be present.     iati-organisations/iati-organisation/total-budget/period-start  
  iso-date The ISO 8601 date. xsd:date   iati-organisations/iati-organisation/total-budget/period-start/@iso-date 1..1
  period-end The ending date for the budget period, in ISO 8601 format (e.g. 2011-03-31 for 31 March 2011). This element must be present.     iati-organisations/iati-organisation/total-budget/period-end  
  iso-date The ISO 8601 date. xsd:date   iati-organisations/iati-organisation/total-budget/period-end/@iso-date 1..1
  value The total value of the organisation’s aid budget for this period. This element is required.     iati-organisations/iati-organisation/total-budget/value  
  currency

A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-activity/@default-currency (or iati-organisation/@default-currency for an organisation file) attribute is specified.

Currency codes are listed at http://iatistandard.org/codelists/currency

xsd:string Currency iati-organisations/iati-organisation/total-budget/value/@currency 0..1
  value-date The date that this value was set (to allow historical currency conversion). The date must be in ISO 8601 format (YYYY-MM-DD). xsd:date   iati-organisations/iati-organisation/total-budget/value/@value-date 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  
  recipient-org The organisation that will receive the funds during the budget period (not the organisation reporting).     iati-organisations/iati-organisation/recipient-org-budget/recipient-org  
  ref Machine-readable identification string for the business object being described. xsd:string   iati-organisations/iati-organisation/recipient-org-budget/recipient-org/@ref 0..1
  xml:lang ISO 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/recipient-org-budget/recipient-org/@xml:lang 0..1
  period-start The starting date for the budget period, in ISO 8601 format (e.g. 2010-04-01 for 1 April 2010). This element must be present.     iati-organisations/iati-organisation/recipient-org-budget/period-start  
  iso-date The ISO 8601 date. xsd:date   iati-organisations/iati-organisation/recipient-org-budget/period-start/@iso-date 1..1
  period-end The ending date for the budget period, in ISO 8601 format (e.g. 2011-03-31 for 31 March 2011). This element must be present.     iati-organisations/iati-organisation/recipient-org-budget/period-end  
  iso-date The ISO 8601 date. xsd:date   iati-organisations/iati-organisation/recipient-org-budget/period-end/@iso-date 1..1
  value The total value of the money budgeted to be disbursed to the specified recipient organisation during this time period. This element is required.     iati-organisations/iati-organisation/recipient-org-budget/value  
  currency

A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-activity/@default-currency (or iati-organisation/@default-currency for an organisation file) attribute is specified.

Currency codes are listed at http://iatistandard.org/codelists/currency

xsd:string Currency iati-organisations/iati-organisation/recipient-org-budget/value/@currency 0..1
  value-date The date that this value was set (to allow historical currency conversion). The date must be in ISO 8601 format (YYYY-MM-DD). xsd:date   iati-organisations/iati-organisation/recipient-org-budget/value/@value-date 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  
  recipient-country The country that will receive the funds during the budget period.     iati-organisations/iati-organisation/recipient-country-budget/recipient-country  
  code Machine readable code for the entity being described. The value should be available on a related codelist. xsd:string Country iati-organisations/iati-organisation/recipient-country-budget/recipient-country/@code 0..1
  xml:lang ISO 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/recipient-country-budget/recipient-country/@xml:lang 0..1
  period-start The starting date for the budget period, in ISO 8601 format (e.g. 2010-04-01 for 1 April 2010). This element must be present.     iati-organisations/iati-organisation/recipient-country-budget/period-start  
  iso-date The ISO 8601 date. xsd:date   iati-organisations/iati-organisation/recipient-country-budget/period-start/@iso-date 1..1
  period-end The ending date for the budget period, in ISO 8601 format (e.g. 2011-03-31 for 31 March 2011). This element must be present.     iati-organisations/iati-organisation/recipient-country-budget/period-end  
  iso-date The ISO 8601 date. xsd:date   iati-organisations/iati-organisation/recipient-country-budget/period-end/@iso-date 1..1
  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  
  currency

A three letter ISO 4217 code for the original currency of the amount. This is required for all currency amounts unless the iati-activity/@default-currency (or iati-organisation/@default-currency for an organisation file) attribute is specified.

Currency codes are listed at http://iatistandard.org/codelists/currency

xsd:string Currency iati-organisations/iati-organisation/recipient-country-budget/value/@currency 0..1
  value-date The date that this value was set (to allow historical currency conversion). The date must be in ISO 8601 format (YYYY-MM-DD). xsd:date   iati-organisations/iati-organisation/recipient-country-budget/value/@value-date 0..1
document-link   A categorized link to an external document.     iati-organisations/iati-organisation/document-link  
  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 The MIME type of the external document, e.g. “application/pdf”. A list of MIME types appears at http://iatistandard.org/codelists/file_format xsd:string File Format iati-organisations/iati-organisation/document-link/@format 0..1
  title A short, human-readable title. May be repeated for different languages.     iati-organisations/iati-organisation/document-link/title  
  xml:lang ISO 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/document-link/title/@xml:lang 0..1
  category

IATI Document Category Code

For the value of the @code attribute, see http://iatistandard.org/codelists/document_category

    iati-organisations/iati-organisation/document-link/category  
  code Machine readable code for the entity being described. The value should be available on a related codelist. xsd:string Document Category iati-organisations/iati-organisation/document-link/category/@code 0..1
  xml:lang ISO 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/document-link/category/@xml:lang 0..1
  language The ISO 639 language code for the target document, e.g. “en”.     iati-organisations/iati-organisation/document-link/language  
  code Machine readable code for the entity being described. The value should be available on a related codelist. xsd:string Language iati-organisations/iati-organisation/document-link/language/@code 0..1
  xml:lang ISO 2 letter code specifying the language of text in this element.   Language iati-organisations/iati-organisation/document-link/language/@xml:lang 0..1
International Aid Transparency Initiative: Organisation-Information Schema

Release 1.05, 2014-10-06

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-10-16