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


The exact date of the planned disbursement OR the starting date of the period in which this specific disbursement will be made.


This element must occur once and only 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-start 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>



The definition of this element was amended for clarity.

Developer tools

Find the source of this documentation on github: