This is the reference page for the XML element period-end. See also the relevant overview page: Budgets


The ending date for the period in which this specific disbursement will be made.


This element must occur no more than once (within each parent element).

period-start must be before period-end



This attribute is required.

This value must be of type xsd:date.

Usage in practice

The period start should define when the actual transfer of funds will take place, if a specific date is known. If the specific payment date is not known, the period in which the transfer is due to take place should be described by using both period-start and period-end dates.

The timeframe between period-start and period-end should not normally exceed 3 calendar months.

Example Usage

Example usage of period-end of planned-disbursement for an iati-activity.

An example date is declared in the @iso-date attribute.
This example date format conform to the xsd:date standard - for most cases YYYY-MM-DD is sufficient.
  <planned-disbursement type="1">
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="EUR" value-date="2014-01-01">3000</value>
   <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>
In some instances, it may not be feasible to declare an period-end date. In such cases, the element is not included:
<planned-disbursement type="1">
        <period-start iso-date="2014-01-01" />
        <value currency="EUR" value-date="2014-01-01">3000</value>



The definition of this element was amended for clarity.

Developer tools

Find the source of this documentation on github:

Last updated on 2015-12-07