This is the reference page for the XML element aid-type. See also the relevant overview page: Transaction


Optional element to override the top-level default-aid-type element (debt relief, etc.) on a transaction-by-transaction basis if needed.


This element may occur any number of times.



A code from the specified vocabulary.

This attribute is required.

This value must be of type xsd:string.

This value must be on the AidType codelist, if the relevant vocabulary is used.


A code for the vocabulary aid-type classifications. If omitted the AidType (OECD DAC) codelist is assumed. The code must be a valid value in the AidTypeVocabulary codelist.

Each selected vocabulary should only be used once for each activity (iati-activity/default-aid-type) or transaction (iati-activity/transaction/aid-type). All activities and/or transactions should contain a code from the DAC Type of Aid Vocabulary. The above guidelines should be converted to rules at the next integer upgrade.

This value must be of type xsd:string.

This value must be on the AidTypeVocabulary codelist.

Example Usage

Example usage of aid-type of a transaction in an iati-activity.

The @code attribute declares a valid code from the specified codelist.
The @vocabulary attribute declares a valid code (1) from the AidTypeVocabulary codelist.
<aid-type code="A01" vocabulary="1" />

The aid-type element can be repeated in any iati-activity.

  <transaction ref="1234" humanitarian="1">
   <transaction-type code="1" />
   <transaction-date iso-date="2012-01-01" />
   <value currency="EUR" value-date="2012-01-01">1000</value>
    <narrative>Transaction description text</narrative>
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" type="10" ref="BB-BBB-123456789">
    <narrative>Agency B</narrative>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" type="23" ref="AA-AAA-123456789">
    <narrative>Agency A</narrative>
   <disbursement-channel code="1" />
   <sector vocabulary="2" code="111" />
   <!--Note: only a recipient-region OR a recipient-country is expected-->
   <recipient-country code="TM" />
   <recipient-region code="616" vocabulary="1" />
   <flow-type code="10" />
   <finance-type code="110" />
   <aid-type code="A01" vocabulary="1" />
   <aid-type code="1" vocabulary="2" />
   <tied-status code="3" />

The vocabulary is used to declare which AidType list is in use. If omitted, an AidType Vocabulary of 1 (OECD DAC) is assumed.

Note: The aid-type element can override the default-aid-type value set in iati-activity



The aid-type element can be reported multiple times within a transaction element added. The @code attribute definition was updated. The @vocabulary attribute was added.

Developer tools

Find the source of this documentation on github: