This is the reference page for the XML element period-end.


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).



This attribute is required.

This value must be of type xsd:date.

period-start/@iso-date must be before or the same as period-end/@iso-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: