Sustainability modules¶

This page documents a mapping from the elements in the CoST IDS sustainability modules to OC4IDS fields and codes.

The mapping for each element covers only the fields needed to satisfy the specific data needs described in the CoST IDS. In order for your data to meet the widest range of user needs, when implementing the mapping, you are encouraged to consider collecting and publishing the other fields described in the OC4IDS schema. To view a field's details, click on its name, e.g. id.

Download this page in PDF format

In Google Chrome, Microsoft Edge or Mozilla Firefox, open the Print dialog (Ctrl+P) and set Destination (Printer, in Microsoft Edge) to 'Save to PDF'. In Safari, open the File menu and click Export as PDF.

Economic and fiscal¶

CoST IDS element

Procurement strategy

Disclose the procurement strategy risk assessment. This tends to be part of the decision-making strategy and likely includes discussions regarding capabilities, the delivery model and the rationale for the risk allocation decision. (E.g. [Document]).

OC4IDS mapping

Project Level:

Add a project document and set its .documentType to 'procurementStrategyRiskAssessment'.

{
  "documents": [
    {
      "id": "1",
      "title": "Procurement strategy risk assessment",
      "documentType": "procurementStrategyRiskAssessment",
      "url": "http://example.com/documents/procurementStrategyRiskAssessment.pdf"
    }
  ]
}

CoST IDS element

Life cycle cost

Disclose the life cycle cost of the project, which is the cost of an asset throughout its life cycle while fulfilling the performance requirements (ISO 15686-5:2017) (E.g. [value]).

OC4IDS mapping

Project Level:

Add a CostMeasurement object to the costMeasurements array and map to its .lifeCycleCosting.value.

{
  "costMeasurements": [
    {
      "id": "1",
      "lifeCycleCosting": {
        "value": {
          "amount": 10000000,
          "currency": "USD"
        }
      }
    }
  ]
}

CoST IDS element

Life cycle cost calculation methodology

Disclose the methodology used to calculate the life-cycle cost. The methodology ought to specify whether income and externalities are included in the calculation and the common date, discount rate and period of analysis used.

OC4IDS mapping

Project Level:

Add a project document and set its .documentType to 'lifeCycleCostMethodology'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "lifeCycleCostMethodology",
      "url": "http://example.com/documents/lifeCycleCostMethodology.pdf"
    }
  ]
}

CoST IDS element

Funding source for preparation, implementation and operation

Name the funding organization(s)/sources of funding for Preparation, Implementation and Operation. If the information is not available for any of the stages, select ['funding/budget source not specified'] for the respective stage where the nature of the funding/budget source could not be identified.

OC4IDS mapping

Project level:

Get the BudgetBreakdowns object in the budget.budgetBreakdowns array whose .description is "Breakdown by stage". If none exists yet, add a BudgetBreakdowns object to the budget.budgetBreakdowns array, set its .id incrementally and its .description to "Breakdown by stage".
For each stage:

a. Get the BudgetBreakdown object in the budget breakdowns' .budgetBreakdown array whose .description is the name of the stage. If none exists yet, add a BudgetBreakdown object to the budget breakdowns' .budgetBreakdown array, set its .id incrementally and set its .description to the name of the stage.

b. Get the Organization object in parties that represents the funding source. If none exists yet, add an organization and add 'funder' to its .roles.

c. Set the budget breakdown's .sourceParty to the .id and .name of the funding source.

{
  "budget": {
    "budgetBreakdowns": [
      {
        "id": "1",
        "description": "Breakdown by stage",
        "budgetBreakdown": [
          {
            "id": "1",
            "description": "Preparation",
            "sourceParty": {
              "id": "1",
              "name": "Agency for Agricultural Development of Morocco"
            }
          },
          {
            "id": "2",
            "description": "Implementation",
            "sourceParty": {
              "id": "1",
              "name": "Agency for Agricultural Development of Morocco"
            }
          }
        ]
      }
    ]
  },
  "parties": [
    {
      "id": "1",
      "name": "Agency for Agricultural Development of Morocco",
      "roles": [
        "funder"
      ]
    }
  ]
}

CoST IDS element

Budget for preparation, implementation and operation

Specify the allocated budget for preparation, implementation, operation. If no amount is allocated for each of the stages, select the option 'amount not allocated" (E.g. Preparation [currency and amount], Implementation[currency and amount], Operation [currency and amount]

OC4IDS mapping

Project level:

Get the BudgetBreakdowns object in the budget.budgetBreakdowns array whose .description is "Breakdown by stage". If none exists yet, add a BudgetBreakdowns object to the budget.budgetBreakdowns array, set its .id incrementally and its .description to "Breakdown by stage".
For each stage:

a. Get the BudgetBreakdown object in the budget breakdowns' .budgetBreakdown array whose .description is the name of the stage. If none exists yet, add a BudgetBreakdown object to the budget breakdowns' .budgetBreakdown array, set its .id incrementally and set its .description to the name of the stage.

b. Map to the budget breakdown's .amount.

{
  "budget": {
    "budgetBreakdowns": [
      {
        "id": "1",
        "description": "Breakdown by stage",
        "budgetBreakdown": [
          {
            "id": "1",
            "description": "Preparation",
            "amount": {
              "amount": 350000,
              "currency": "USD"
            }
          },
          {
            "id": "2",
            "description": "Implementation",
            "amount": {
              "amount": 300000,
              "currency": "USD"
            }
          }
        ]
      }
    ]
  }
}

CoST IDS element

Cost benefit analysis

Disclose the project cost-benefit analysis. This information tends to be part of the appraisal documents. (E.g. [Document]).

OC4IDS mapping

Project Level:

Add a project document and set its .documentType to 'costBenefitAnalysis'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "costBenefitAnalysis",
      "url": "http://example.com/documents/costBenefitAnalysis.pdf"
    }
  ]
}

CoST IDS element

Value for money

A summary of the value for money analysis carried out for the project, along with supporting figures, calculations and business case, based on projected or actual procurement outcomes. This tends to include considerations of economy, efficiency, effectiveness and equity, and is part of the appraisal documents. (E.g. [Document]).

OC4IDS mapping

Project Level: Add a project document and set its .documentType to 'valueForMoneyAnalysis'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "valueForMoneyAnalysis",
      "url": "http://example.com/documents/valueForMoneyAnalysis.pdf"
    }
  ]
}

CoST IDS element

Budget projections

In case of multiyear project implementation, disclose information on budget projection for all years of implementation (E.g. Y1: [currency and amount], Y2: [currency and amount], etc).

OC4IDS mapping

Project level:

Add a BudgetBreakdowns object to the budget.budgetBreakdowns array, set its .id incrementally and set its .description to "Breakdown by year of implementation".
For each year:
1. Add a BudgetBreakdown object to the budget breakdowns' .budgetBreakdown array and set its .id incrementally.
2. Map the year's start and end dates to its .period
3. Map the budget projection to its .amount.

{
  "budget": {
    "budgetBreakdowns": [
      {
        "id": "1",
        "description": "Breakdown by year of implementation",
        "budgetBreakdown": [
          {
            "id": "1",
            "period": {
              "startDate": "2024-01-01T00:00:00Z",
              "endDate": "2024-12-31T00:00:00Z"
            },
            "amount": {
              "amount": 350000,
              "currency": "USD"
            }
          },
          {
            "id": "2",
            "period": {
              "startDate": "2025-01-01T00:00:00Z",
              "endDate": "2025-12-31T00:00:00Z"
            },
            "amount": {
              "amount": 300000,
              "currency": "USD"
            }
          }
        ]
      }
    ]
  }
}

CoST IDS element

Budget shortfall

Disclose any shortfall in the allocated budget (E.g. [currency and amount] and [free text: reasons for the funding shortfall]

OC4IDS mapping

Project level:

Add a Metric object to the metrics array, set its .id incrementally and set its .title to "Budget shortfall".
Add an Observation object to the metric's .observations array and set its .id incrementally.
Map the shortfall's value to its .value.
Map the reasons for the shortfall to its .notes.

{
  "metrics": [
    {
      "id": "1",
      "title": "Budget shortfall",
      "observations": [
        {
          "id": "1",
          "value": {
            "amount": 2500000,
            "currency": "USD"
          },
          "notes": "Funding shortfall due to construction overruns and a lack of budgetary approval"
        }
      ]
    }
  ]
}

Environment and climate¶

CoST IDS element

Environmental impact category

Indicate the category that reflects the magnitude of environmental impact. Consider the following to rate the project:

Category A: projects with potential significant adverse environmental or social risks and/or impacts that are diverse, irreversible, or unprecedented.
Category B: projects with potential limited adverse environmental or social risks and/or impacts that are few in number, generally site-specific, largely reversible, and readily addressed through mitigation measures.
Category C: projects with minimal or no adverse environmental or social risks and/or impacts.

(Select from a list: A/B/C - Specify list as IFC's Environmental and Social Categorization).

OC4IDS mapping

Project level:

If an environmental impact assessment was conducted:

Set environment.hasImpactAssessment to true.
Add a Classification object to the environment.impactCategories array, set its .scheme to 'ifc-environmental-social' and set its .id to the lowercase letter of the category into which the project falls.

If an environmental impact assessment was not conducted, set environment.hasImpactAssessment to false.

{
  "environment": {
    "hasImpactAssessment": true,
    "impactCategories": [
      {
        "scheme": "ifc-environmental-social",
        "id": "a"
      }
    ]
  }
}

CoST IDS element

Environmental measures

Disclose the measures adopted by the project to mitigate and/or remedy the environmental impact (E.g. [free text justification/explaining the measures adopted] and document).

OC4IDS mapping

Project level:

Add a project document, set its .documentType to 'environmentalMeasures' and map the justification and explanation to its .description.

{
  "documents": [
    {
      "id": "1",
      "documentType": "environmentalMeasures",
      "description": "The following environmental measures are adopted by the project...",
      "url": "http://example.com/documents/environmentalMeasures.pdf"
    }
  ]
}

CoST IDS element

Environmental exceptions

Disclose all exemptions and/or amnesties obtained for the project. (E.g. [Document]). This can be planning, environmental, construction and/or operational related.

OC4IDS mapping

Project Level:

Add a project document and set its .documentType to 'environmentalExemption'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "environmentalExemption",
      "url": "http://example.com/documents/environmentalExemption.pdf"
    }
  ]
}

CoST IDS element

Protected area

Identify whether the project is located in a protected area. Use the project location/coordinates at the WDPA - World Database of Protected Areas to disclose the information.

OC4IDS mapping

Project level:

If the project is located in a protected area:

Set environment.inProtectedArea to true.
Add a Location object to the .locations array, set its .id incrementally and set its .gazetteer.scheme to 'WDPA'.
For each protected area in which the project is located, add the area's WDPA identifier to the .gazetteer.identifiers array.

If the project is not located in a protected area, set environment.inProtectedArea to false.

{
  "environment": {
    "inProtectedArea": true
  },
  "locations": [
    {
      "id": "1",
      "gazetteer": {
        "scheme": "WDPA",
        "identifiers": [
          "555566673"
        ]
      }
    }
  ]
}

CoST IDS element

Conservation measures

Disclose and provide further details on the measures adopted by the project to protect and enhance biodiversity. This can comprise, without limitation the following:

avoidance of ecological sitting
buffers for ecological land
nature-based solutions
land restoration
protection to landscape and historical sites
invasive species management
management of wildlife mortality risk
reduce habitat loss
pollution reduction
soil management
hazardous material management])
others (explain)

OC4IDS mapping

Project level:

For each measure, add a ConservationMeasure object to the environment.conservationMeasures array, set its .type according to the open conservationMeasure codelist and map any further details to its .description.
If there is an accompanying document, add a project document and set its .documentType to 'conservationMeasures'.

{
  "environment": {
    "conservationMeasures": [
      {
        "type": "habitatRestoration",
        "description": "Habitat restoration measures for the project include..."
      }
    ]
  },
  "documents": [
    {
      "id": "1",
      "documentType": "conservationMeasures",
      "url": "http://example.com/conservationMeasures.pdf"
    }
  ]
}

CoST IDS element

Climate and disaster risk assessment

Clarify the type of climate and disaster risks to which the project is exposed to (E.g. [document or free text to list and explain risks]). This tends to be part of the appraisal documents.

OC4IDS mapping

Project level:

Add a project document, set its .documentType to 'climateAndDisasterRiskAssessment' and map any free text to its .description.

{
  "documents": [
    {
      "id": "1",
      "documentType": "climateAndDisasterRiskAssessment",
      "description": "The project is exposed to the following climate and disaster risks...",
      "url": "http://example.com/documents/climateAndDisasterRiskAssessment.pdf"
    }
  ]
}

CoST IDS element

Climate measures

Clarify whether the project design considered climate change mitigation and/or adaptation measures,. disclosing the design demonstrating how the measures were incorporated. This can comprise, without limitation the following:

use of lower-emission sources of energy use of lower-emission materials use of recycled and reused materials regenerative design retrofitting design use of carbon capture technology assessment of extreme weather events assessment of precipitation patterns assessment of rising temperatures assessment of rising sea levels others (explain)

And [Document]).

OC4IDS mapping

Project level:

For each measure, add a ClimateMeasure object to the environment.climateMeasures array, set its .type according to the open climateMeasures codelist and map any further explanation to its .description.
If there is an accompanying document, add a project document and set its .documentType to 'climateMeasures'.

{
  "environment": {
    "climateMeasures": [
      {
        "type": [
          "regenerativeDesign"
        ],
        "description": "Regenerative design measures for the project include biomimicry to imitate nature."
      }
    ]
  },
  "documents": [
    {
      "id": "1",
      "documentType": "climateMeasures",
      "url": "http://example.com/climateMeasures.pdf"
    }
  ]
}

CoST IDS element

Forecast of greenhouse gas emissions

Disclose the forecast greenhouse gas emissions related to the project, informing the calculation, the methodology applied and where the calculation can be found (E.g. [amount] and [free text for methodology clarification]).

OC4IDS mapping

Project level:

Add a Metric object to the .forecasts array.
Set the metric's .title to "Greenhouse gas emissions (carbon dioxide equivalent)" and map the methodology clarification to its .description.
Add an Observation object to the metric's .observations array and:

Map the amount of greenhouse gas emissions in tonnes of CO2 equivalent to the observation's .measure
Set the .unit.name to "Tonne (metric ton)", .unit.scheme to 'UNCEFACT' and .unit.id to "TNE"
Set .period to the period covered by the forecast.

If supporting documentation is available, add a project document and set its .documentType to 'ghgEmissionsForecast'.

{
  "forecasts": [
    {
      "id": "1",
      "title": "Greenhouse gas emissions (carbon dioxide equivalent)",
      "description": "Emission forecasts are calculated using the following methodology...",
      "observations": [
        {
          "id": "1",
          "period": {
            "startDate": "2024-01-01T00:00:00Z",
            "endDate": "2049-12-31T00:00:00Z"
          },
          "measure": 1000000,
          "unit": {
            "name": "Tonne (metric ton)",
            "scheme": "UNCEFACT",
            "id": "TNE"
          }
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "1",
      "documentType": "ghgEmissionsForecast",
      "url": "http://example.com/GhgEmissionForecast.pdf"
    }
  ]
}

CoST IDS element

Environmental certifications

Disclose environmental and/or climate related certifications issued for contractors and subcontractors such as ISO 14001 for environmental management (E.g. [Document]).

OC4IDS mapping

Contracting process level:

Add a contracting process document and set its .documentType to 'supplierEnvironmentalCertification'.

{
  "contractingProcesses": [
    {
      "id": "1",
      "summary": {
        "documents": [
          {
            "id": "1",
            "documentType": "supplierEnvironmentalCertification",
            "url": "http://example.com/documents/contractorEnvironmentalCertification.pdf"
          }
        ]
      }
    }
  ]
}

CoST IDS element

Decommissioning plans

Disclose the decommissioning plans for the project assets [document]..

OC4IDS mapping

Project level:

Add a project document and set its .documentType to 'decommissioningPlans'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "decommissioningPlans",
      "url": "http://example.com/documents/decommissioningPlans.pdf"
    }
  ]
}

CoST IDS element

Decommissioning cost forecast

Disclose the forecast decommissioning costs for the project assets [value, currency].

OC4IDS mapping

Project level:

Add a CostMeasurement object to the costMeasurements array and set its .id incrementally.
Add a CostGroup object to the cost measurement's .costGroups array, set its .id incrementally and set its .category to 'endOfLife'.
Add a Cost object to the cost group's .costs array, set its .id incrementally and map to its .value.

{
  "costMeasurements": [
    {
      "id": "1",
      "costGroups": [
        {
          "id": "1",
          "category": "endOfLife",
          "costs": [
            {
              "id": "1",
              "value": {
                "amount": 50000000,
                "currency": "USD"
              }
            }
          ]
        }
      ]
    }
  ]
}

Climate finance¶

CoST IDS element

Climate objective

Disclose the main climate objective that the project addresses.

Select from a list: Eg:

mitigation
adaptation
cross-cutting

OC4IDS mapping

Project level:

Map to environment.goals using the closed environmentalGoal codelist.

{
  "environment": {
    "goals": [
      "climateChangeMitigation",
      "climateChangeAdaptation"
    ]
  }
}

CoST IDS element

Financial instrument

Disclose the financial instrument type from the list:

loan
- concessional
- non-concessional
grant
equity
guarantees

OC4IDS mapping

Get the Finance object in .udget.finance or contractingProcesses.summary.finance that represents the financing arrangement. If none exists yet, add a financing arrangement.
Set the the financing arrangement's .assetClass and .type according to the instrument type:

Instrument type	`.assetClass`	`.type`
loan	'debt'	'loan'
grant		'grant'
equity	'equity'	'shares.listed' or 'shares.unlisted'
guarantee		'guarantee'

If the instrument is a concessional loan, set .concessional to true.
If the instrument is a non-concessional loan, set .concessional to false.
If the instrument is results-based, set .resultsBased to true.

{
  "budget": {
    "finance": [
      {
        "id": "1",
        "assetClass": [
          "debt"
        ],
        "type": "loan",
        "concessional": false,
        "resultsBased": true
      }
    ]
  }
}

CoST IDS element

Climate transformation

Clarify the theory of change, systemic transition or transformation that is intended [free text to explain].

OC4IDS mapping

Project level:

Add a project document, set its .documentType to 'climateTransformation' and map any free text to .description.

{
  "documents": [
    {
      "id": "1",
      "documentType": "climateTransformation",
      "url": "http://example.com/climateTransformation.pdf"
    }
  ]
}

CoST IDS element

Climate finance decision-maker

Identify who approved the climate finance investment in the country (organization, party, role)

OC4IDS mapping

Project level:

Add an organization for the decision maker and add 'climateFinanceFocalPoint' to its .roles array.

{
  "parties": [
    {
      "id": "1",
      "name": "Presidential Climate Commission",
      "roles": [
        "climateFinanceFocalPoint"
      ]
    }
  ]
}

CoST IDS element

Nationally Determined Contributions (NDC)

Clarify how the investment is aligned with the country's nationally determined contributions. [codelist, free text to explain].

OC4IDS mapping

See policy coherence (institutional module).

CoST IDS element

Paris Agreement

Clarify how the investment is aligned with the country's Paris Agreement commitments. [codelist, free text to explain].

OC4IDS mapping

See policy coherence (institutional module).

CoST IDS element

Beneficiaries

Disclose who is the climate finance investment intended to benefit [free text to explain the beneficiaries] and number of beneficiaries. [Select from the list: Direct Indirect]

OC4IDS mapping

See number of beneficiaries (social module)

CoST IDS element

Amount of investment

Disclose the quantum of the climate finance investment [value, currency].

OC4IDS mapping

Get the Finance object in budget.finance or contractingProcesses.summary.finance that represents the financing arrangement. If none exists yet, add a financing arrangement.
Map to the financing arrangement's .value.

{
  "budget": {
    "finance": [
      {
        "id": "1",
        "value": {
          "amount": 3000000,
          "currency": "EUR"
        }
      }
    ]
  }
}

CoST IDS element

Funding source

Disclose who is providing the finance [party/organization/role].

OC4IDS mapping

Get the Finance object in budget.finance or contractingProcesses.summary.finance that represents the financing arrangement. If none exists yet, add a financing arrangement.
Map to the financing arrangement's .source.

{
  "budget": {
    "finance": [
      {
        "id": "1",
        "source": "Green Climate Fund"
      }
    ]
  }
}

CoST IDS element

Green Climate Fund Accredited Entity

For projects financed by the Green Climate Fund, disclose the accredited entities through which GCF resources are accessed.

OC4IDS mapping

Get the Finance object in budget.finance or contractingProcesses.summary.finance that represents the financing arrangement. If none exists yet, add a financing arrangement.
Get the Organization object in parties that represents the party providing the finance. If none exists yet, add an organization and add 'funder' to its .roles.
Set the financing arrangement's .financingParty to the .id and .name of the organization.

{
  "budget": {
    "finance": [
      {
        "id": "1",
        "financingParty": {
          "id": "1",
          "name": "Agency for Agricultural Development of Morocco"
        }
      }
    ]
  },
  "parties": [
    {
      "id": "1",
      "name": "Agency for Agricultural Development of Morocco",
      "roles": [
        "funder"
      ]
    }
  ]
}

CoST IDS element

Accredited Entity Type

Select from the lists:

Private
Public
non-governmental
sub-national
national
regional
international

OC4IDS mapping

Get the Organization object in parties that represents the accredited entity. If none exists yet, add an organization and add 'funder' to its .roles.
Add a Classification object to the organization's .classifications array, set its .scheme to 'costIdsLegalType' and map the organization's legal type ('private', 'public' or 'non-government') to its .id.
Add a Classification object to the organization's .classifications array, set its .scheme to 'costIdsAdministrativeLevel' and map the organization's administrative level ('international', 'regional', 'national' or 'sub-national') to its .id.

{
  "parties": [
    {
      "id": "1",
      "name": "Development Bank of South Africa",
      "roles": [
        "funder"
      ],
      "classifications": [
        {
          "id": "public",
          "scheme": "costIdsLegalType"
        },
        {
          "id": "national",
          "scheme": "costIdsAdministrativeLevel"
        }
      ]
    }
  ]
}

CoST IDS element

Project preparation costs

Disclose the amounts invested in project preparation [value, currency].

OC4IDS mapping

See budget for preparation, implementation and operation (economic and fiscal module).

CoST IDS element

Project preparation period

Disclose dates for project preparation [start date, end date].

OC4IDS mapping

Project level:

Map to preparationPeriod.

{
  "preparationPeriod": {
    "startDate": "2016-07-01T00:00:00Z",
    "endDate": "2016-12-31T00:00:00Z"
  }
}

CoST IDS element

Project approval period

Disclose dates for project approval [submission date, approval date].

OC4IDS mapping

Project level:

For each date:

Add a Milestone to the milestones array and set its:

.id incrementally
.type to 'financing'
.status to 'met'

If disclosing the submission date, set the milestone's .title to "Climate finance submission" and its .dateMet to the date of the submission.
If disclosing the approval date, set the milestone's .title to "Climate finance approval" and its .dateMet to the date of the approval.

{
  "milestones": [
    {
      "id": "1",
      "title": "Climate finance submission",
      "type": "financing",
      "dateMet": "2023-06-01T00:00:00Z",
      "status": "met"
    }
  ]
}

CoST IDS element

Ratio of co-finance

Disclose the ratio of co-finance. Select from a list to specify amounts.

Eg:
Domestic mobilisations [value or NA] Private Finance [value or NA]

OC4IDS mapping

The OC4IDS data model provides the information needed to calculate co-finance ratios by modeling a project's individual financing arrangements. For more information, see the mappings for amount of investment, funding source, Green Climate Fund Accredited Entity and Accredited Entity Type.

{
  "budget": {
    "finance": [
      {
        "id": "1",
        "source": "Green Climate Fund",
        "value": {
          "amount": 3000000,
          "currency": "USD"
        }
      },
      {
        "id": "2",
        "source": "GEF Trust Fund",
        "value": {
          "amount": 150000,
          "currency": "USD"
        }
      }
    ]
  }
}

CoST IDS element

Terms of climate finance

This includes several financial terms:

maturity (years)
Grace period (years)
annual principal repayment years (% of initial principle)
Interest (%)
Service fee (per annum)
Commitment fee (per annum)

OC4IDS mapping

Get the Finance object in budget.finance or contractingProcesses.summary.finance that represents the financing arrangement. If none exists yet, add a financing arrangement.
Map the terms to the financing arrangement's properties:

Maturity: .period
Grace period: Map the period over which payments will be made to .paymentPeriod. The grace period is the difference between .period and .paymentPeriod.
Annual principal repayment years: .description
Interest: .interestRate
Service fee: .description
Commitment fee: .description

{
  "budget": {
    "finance": [
      {
        "id": "1",
        "period": {
          "startDate": "2024-01-01T00:00:00Z",
          "endDate": "2043-12-31T00:00:00Z"
        },
        "paymentPeriod": {
          "startDate": "2029-01-01T00:00:00Z",
          "endDate": "2043-12-31T00:00:00Z"
        },
        "interestRate": {
          "margin": 0.0075
        },
        "description": "Annual principal repayment years 11-20 (% of initial principal): 6.7%. Service fee (per annum): 0.50%. Commitment fee (per annum): Up to 0.75%."
      }
    ]
  }
}

CoST IDS element

Carbon efficiency

Disclose the cost per tonne of CO2 equivalent [value, currency].

OC4IDS mapping

Project level:

Map to environment.abatementCost. If a document that describes the methodology used to calculate the cost is available, add a project document and set its .documentType to 'abatementCostMethodology'.

{
  "environment": {
    "abatementCost": {
      "amount": 12.29,
      "currency": "USD"
    }
  },
  "documents": [
    {
      "id": "1",
      "documentType": "abatementCostMethodology",
      "url": "http://example.com/abatementCostMethodology.pdf"
    }
  ]
}

CoST IDS element

Non-climate co-benefits

Identify potential non-climate impacts that have been factored into the project planning. Select from the list:

economic
social
environmental
gender empowerment

[add free text to explain the co-benefits].

OC4IDS mapping

Project level:

For each co-benefit, add a Benefit object to the benefits array, map the option from the list to its .title and map the explanation to its .description.

{
  "benefits": [
    {
      "title": "environmental",
      "description": "The new water management plant will mean less water is removed from the delta meaning more is left in place for use by the local biome."
    }
  ]
}

CoST IDS element

Public consultation meetings

Disclose the occurrence of public meetings with communities and impacted groups including the minutes, number of the participants, dates and location of these meetings (E.g. Meeting 1 [date] [location] [number of participants] [Document], Meeting 2 [date] [location] [number of participants], [Document]).

OC4IDS mapping

See public consultation meetings (social module).

CoST IDS element

Disbursement records

Disbursements dates according to financial agreement versus actual disbursements dates [value, currency, date].

OC4IDS mapping

For each planned disbursement:

If the disbursement relates to a contracting processes, for example a payment from a funder to a supplier or to a subcontractor of a supplier, get the ContractingProcess in the contractingProcesses array to which the disbursement relates and add a Milestone object to its .summary.milestones array. Otherwise, if the disbursement relates to the project, for example a payment from a funder to the public authority, add a Milestone object to the project-level milestones array.
Set the milestone's:

.id incrementally
.status to 'scheduled'
.dueDate to the date on which the disbursement is planned to occur
.type to 'payment'
.value to the amount and currency of the planned disbursement

For each actual disbursement:

If the disbursement relates to a contracting processes, for example a payment from a funder to a supplier or to a subcontractor of a supplier, get the ContractingProcess in the contractingProcesses array to which the disbursement relates and add a Transaction object to its .summary.transactions array. Otherwise, if the disbursement relates to the project, for example a payment from a funder to the public authority, add a Transaction object to the project-level transactions array.
Set the transaction's:

.id incrementally
.date to the date of the disbursement
.value to the amount and currency of the disbursement.

Get the Organization in parties that represents the payer. If none exists yet, add an organization for the payer:

Add 'payer' to the organization's .roles array
Set the transaction's .payer to the .id and .name of the organization.

Get the Organization in parties that represents the payee. If none exists yet, add an organization for the payee:

Add 'payee' to the organization's .roles array.
Set the transaction's .payee to the .id and .name of the organization.

Get the Milestone in milestones that represents that planned disbursement:

Set its .status to 'met'
Set its .dateMet to the date of the disbursement
Set the transaction's .relatedImplementationMilestone to the .id and .title of the milestone.

{
  "milestones": [
    {
      "id": "1",
      "title": "Grant disbursement",
      "status": "met",
      "dueDate": "2023-07-01T00:00:00Z",
      "dateMet": "2023-08-01T00:00:00Z",
      "type": "payment",
      "value": {
        "amount": 5000000,
        "currency": "USD"
      }
    }
  ],
  "transactions": [
    {
      "id": "1",
      "date": "2023-08-01T00:00:00Z",
      "value": {
        "amount": 5000000,
        "currency": "USD"
      },
      "payer": {
        "id": "1",
        "name": "United Nations Development Programme"
      },
      "payee": {
        "id": "2",
        "name": "Ministry of works"
      },
      "relatedImplementationMilestone": {
        "id": "1",
        "title": "Grant disbursement"
      }
    }
  ]
}

CoST IDS element

Type of project monitoring

Select from a list:

internal
external
mixed

OC4IDS mapping

Project level:

Map to environment.climateOversightTypes using the closed climateOversightTypes codelist.

{
  "environment": {
    "climateOversightTypes": [
      "internal",
      "external"
    ]
  }
}

CoST IDS element

Performance monitoring

Disclose Key Performance Indicators adopted by the project (E.g. [free text]).

OC4IDS mapping

Project level:

For each KPI, add a Metric object to the metrics array and set its fields according to the schema. Prefix the metric's .title with "KPI: ".

{
  "metrics": [
    {
      "id": "1",
      "title": "KPI: Capacity utilization"
    }
  ]
}

CoST IDS element

Reporting period

It could be quarterly, annually, biannually, etc. [free text].

OC4IDS mapping

Project level:

Get the Metric object in the metrics array that represents the KPI and map to its .description using the format "Reporting period: {period}".

{
  "metrics": [
    {
      "id": "1",
      "title": "KPI: Capacity utilization",
      "description": "Reporting period: Annual"
    }
  ]
}

CoST IDS element

Oversight reports

Disclose oversight reports.[document].

OC4IDS mapping

Project level:

Add a project document and set its .documentType to 'oversightReport'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "oversightReport",
      "url": "http://example.com/oversightReport"
    }
  ]
}

CoST IDS element

Independent monitoring

Identify the entities acting as independent monitors of the project (E.g. [free text]).

OC4IDS mapping

See independent monitoring (institutional module).

CoST IDS element

Independent evaluation

Disclose technical audits produced at end of the project (E.g. [free text].

OC4IDS mapping

Project level:

For each audit report, add a project document, set its .documentType to 'technicalAuditReport' and map any free text to its .description.

{
  "documents": [
    {
      "id": "1",
      "documentType": "technicalAuditReport",
      "description": "The project has been constructed as specified...",
      "url": "http://example.com/technicalAuditReport.pdf",
      "pageStart": "13",
      "pageEnd": "14"
    }
  ]
}

CoST IDS element

Impact measurement

Clarify the methodology or system to measure the long-term impact of the project solution (E.g. [free text].

OC4IDS mapping

Project level:

Add a project document, set its .documentType to 'impactMethodology' and map any free text to its .description.

{
  "documents": [
    {
      "id": "1",
      "documentType": "impactMethodology",
      "description": "The long term impact of this project will be measured according to...",
      "url": " http://example.com/impactMethodology.pdf "
    }
  ]
}

CoST IDS element

Carbon footprint

Disclose the carbon footprint of the project, informing the calculation, the methodology applied, and where the calculation can be found. [value, tons CO2 equivalent, free text to describe the methodology used to measure the carbon footprint].

OC4IDS mapping

Project level:

Add a Metric object to the metrics array.
Set the metric's .title to "Greenhouse gas emissions (carbon dioxide equivalent)" and map the methodology clarification to its .description.
Add an Observation object to the metric's .observations array and:

Map the amount of greenhouse gas emissions in tonnes of CO2 equivalent to the observation's .measure
Set the .unit.name to "Tonne (metric ton)", .unit.scheme to 'UNCEFACT' and .unit.id to "TNE"
Set .period to the period covered by the calculation.

If supporting documentation is available, add a project document and set its .documentType to 'ghgEmissions'.

{
  "metrics": [
    {
      "id": "1",
      "title": "Greenhouse gas emissions (carbon dioxide equivalent)",
      "description": "Emissions are calculated using the following methodology...",
      "observations": [
        {
          "id": "1",
          "period": {
            "startDate": "2024-01-01T00:00:00Z",
            "endDate": "2049-12-31T00:00:00Z"
          },
          "measure": 1000000,
          "unit": {
            "name": "Tonne (metric ton)",
            "scheme": "UNCEFACT",
            "id": "TNE"
          }
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "1",
      "documentType": "ghgEmissions",
      "url": " http://example.com/ghgEmissions.pdf "
    }
  ]
}

CoST IDS element

Infrastructure assets to be decommissioned

Identify the asset for disposal purpose [free text].

OC4IDS mapping

For each set of decommissioned assets in a specified location, create a new OC4IDS project and:

Set its type to 'decommissioning'.
Set its title to the name of the asset.
Add a RelatedProject object to the relatedProjects array and set its:

.id and .title to the .id and .title of the OC4IDS project for the replacement of the asset
.scheme to 'oc4ids'
.relationship to 'replacement'.

{
  "id": "oc4ids-bu3kcz-123456789",
  "title": "Otahuhu B Power Station",
  "type": "decommissioning",
  "relatedProjects": [
    {
      "id": "oc4ids-bu3kcz-987654321",
      "scheme": "oc4ids",
      "title": "Otahuhu C Power Station",
      "relationship": "replacement"
    }
  ]
}

CoST IDS element

Decommission period

Intended start and end dates of decommissioning.

OC4IDS mapping

Project level:

Map to decommissioningPeriod.

{
  "decommissioningPeriod": {
    "startDate": "2040-07-01T00:00:00Z",
    "endDate": "2041-06-30T00:00:00Z"
  }
}

CoST IDS element

Decommission plan

Disclose the technical plan for decommissioning (E.g.: [Doc]).

OC4IDS mapping

See decommissioning plans (environment and social).

CoST IDS element

Carbon decommission savings

Disclose the evaluation of CO2 savings as a result of decommissioning [value, tons CO2 equivalent].

OC4IDS mapping

Project level:

Add a Metric object to the forecasts array.
Set the metric's .title to "Greenhouse gas emissions reduction (carbon dioxide equivalent)" and map the methodology clarification to its .description.
Add an Observation object to the metric's .observations array and:

Map the amount of greenhouse gas emission savings in tonnes of CO2 equivalent to the observation's .measure
Set the .unit.name to "Tonne (metric ton)", .unit.scheme to 'UNCEFACT' and .unit.id to "TNE"
Set .period to the period covered by the calculation.

If supporting documentation is available, Add a project document and set its .documentType to 'ghgEmissionsReduction'.

{
  "id": "oc4ids-bu3kcz-123456789",
  "forecasts": [
    {
      "id": "1",
      "title": "Greenhouse gas emissions reduction (carbon dioxide equivalent)",
      "description": "Emission reduction forecasts are calculated using the following methodology...",
      "observations": [
        {
          "id": "1",
          "period": {
            "startDate": "2024-01-01T00:00:00Z",
            "endDate": "2049-12-31T00:00:00Z"
          },
          "measure": 1000000,
          "unit": {
            "name": "Tonne (metric ton)",
            "scheme": "UNCEFACT",
            "id": "TNE"
          }
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "1",
      "documentType": "ghgEmissionsReduction",
      "url": " http://example.com/GhgEmissionsReduction.pdf "
    }
  ]
}

CoST IDS element

Decommission mitigation plan

Disclose mitigation plan for people and communities affected by decommissioning (E.g.: [Doc]).

OC4IDS mapping

Project level:

Add a project document and set its .documentType to 'socialImpact'.

{
  "id": "oc4ids-bu3kcz-123456789",
  "documents": [
    {
      "id": "1",
      "documentType": "socialImpact",
      "url": "http://example.com/socialImpact.pdf",
      "pageStart": "13",
      "pageEnd": "14"
    }
  ]
}

Institutional¶

CoST IDS element

Policy coherence

Disclose documentation that evidences that the project is part of, or aligned with existing plans and policies, providing further details on the project's policy alignment. Consider alignment with:

SDGs
National plan or strategy
Infrastructure plan or strategy
Sector plan or strategy
Procuring entity plan or strategy
Paris Agreement
Nationally Determined Contributions (NDCs)
National Adaptation Plans
Medium-term fiscal frameworks/targets

[free text]

OC4IDS mapping

Project level:

For each plan or policy to which the project is aligned, add a code from the open policyAlignment codelist to the policyAlignment.policies array and add a further explanation of the alignment to policyAlignment.description.
For each United Nations Sustainable Development Goal to which the project is aligned, add a Classification object to the additionalClassifications array and set its:

.scheme to 'sdg'
.id to the goal's number
.description to the goal's title.

For each United Nations Sustainable Development Goal Target to which the project is aligned, add a Classification object to the additionalClassifications array and set its:

.scheme to 'sdgTarget'
.id to the target's number
.description to the target's title.

If further documentation of the project's policy alignment is available, add a project document and set its .documentType to 'policyAlignment'.

{
  "additionalClassifications": [
    {
      "scheme": "sdg",
      "id": "6",
      "description": "Ensure availability and sustainable management of water and sanitation for all"
    },
    {
      "scheme": "sdgTarget",
      "id": "6.3",
      "description": "By 2030, improve water quality by reducing pollution, eliminating dumping and minimizing release of hazardous chemicals and materials, halving the proportion of untreated wastewater and substantially increasing recycling and safe reuse globally"
    }
  ],
  "policyAlignment": {
    "policies": [
      "infrastructurePlan"
    ],
    "description": "The project is intended to contribute towards the goals set out in the 2021 Australian Infrastructure Plan."
  },
  "documents": [
    {
      "id": "1",
      "documentType": "policyAlignment",
      "url": "http://example.com/infrastructurePlanAlignment.pdf"
    }
  ]
}

CoST IDS element

Freedom of information requests

Disclose Freedom of Information (FoI) requests that have been presented in relation to the project [E.g. Document]. Note that FoI requests can also be known as access to information requests.

OC4IDS mapping

Project level:

For each freedom of information request, add a project document and set its .documentType to 'informationRequest'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "informationRequest",
      "url": "http://example.com/foiRequest-1.pdf"
    }
  ]
}

CoST IDS element

Answers to Freedom of information requests

Disclose the responses provided by authorities to Freedom of Information (FoI) requests related to the project (Eg. [Document]). Note that FoI requests may also be known as access to information requests.

OC4IDS mapping

Project level:

For each freedom of information request response, add a project document and set its .documentType to 'informationRequestResponse'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "informationRequestResponse",
      "url": "http://example.com/foiRequest-1.pdf"
    }
  ]
}

CoST IDS element

Lobbying transparency

Disclose the occurrence of meetings with interest groups, including the meeting agenda and minutes, the number of the participants, dates and location of these meetings (E.g. Meeting 1 [date] [location] [number of participants] [Document], Meeting 2 [date] [location] [number of participants] [Document]).

OC4IDS mapping

Project Level:

For each meeting:

Publish the meeting details:

Add a Meeting object to the lobbyingMeetings array and set:

.id incrementally
.date to the date of the meeting
.address to the address of the meeting
.numberOfParticipants to the number of people present at the meeting
.publicOffice.person.name to the name of the person representing the public office present at the meeting
.publicOffice.jobTitle to the job title of the person representing the public office present at the meeting.

Get the Organization in parties that represents the public office. If none exists yet, add an organization.
Set the meeting's .publicOffice.organization to the .id and .name of the organization.

Publish the meeting minutes: add a project document and set its .documentType to 'minutes.lobbyingMeeting'.

{
  "lobbyingMeetings": [
    {
      "id": "1",
      "date": "2024-01-01T00:00:00Z",
      "address": {
        "streetAddress": "1600 Amphitheatre Pkwy",
        "locality": "London",
        "region": "London",
        "postalCode": "WC1 8HG",
        "countryName": "United Kingdom"
      },
      "numberOfParticipants": 4,
      "publicOffice": {
        "person": {
          "name": "Brett Gliddon"
        },
        "organization": {
          "name": "Motorways UK",
          "id": "GB-GOR-XX1234"
        },
        "jobTitle": "Group General Manager Transport Services"
      }
    }
  ],
  "documents": [
    {
      "id": "2",
      "documentType": "minutes.lobbyingMeeting",
      "url": "http://example.com/lobbyingMeetingMinutes.pdf"
    }
  ]
}

CoST IDS element

Beneficial ownership

Disclose the beneficial owners of the contractors and suppliers appointed in the project (E.g. [name, identifier]).

OC4IDS mapping

Project level:

For each beneficial owner:

Get the Organization in parties that represents the contractor or supplier.
Add a Person object to the organization's .beneficialOwners array.
Set the person's:

.id incrementally
.name to the beneficial owner's name
.identifier to the beneficial owner's identifier

{
  "parties": [
    {
      "id": "1",
      "beneficialOwners": [
        {
          "id": "1",
          "name": "Juan Perez",
          "identifier": {
            "scheme": "PRY-IDCARD",
            "id": "12345"
          }
        }
      ]
    }
  ]
}

CoST IDS element

Sustainability criteria

Identify the presence of sustainability and non-price attributes in the award criteria.

OC4IDS mapping

Contracting process level:

Add a Sustainability object to the summary.tender.sustainability array and add 'awardCriteria' to its .strategies array.

{
  "contractingProcesses": [
    {
      "id": "1",
      "summary": {
        "tender": {
          "sustainability": [
            {
              "strategies": [
                "awardCriteria"
              ]
            }
          ]
        }
      }
    }
  ]
}

CoST IDS element

Anti-corruption certifications

Disclose anti-corruption certifications of the project, such as ISO 37001 on Anti-Bribery Management Systems Standard (E.g. [Document]).

OC4IDS mapping

Project Level:

Add a project document and set its .documentType to 'antiCorruptionCertification'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "antiCorruptionCertification",
      "url": "http://example.com/ISO37001Certification.pdf"
    }
  ]
}

CoST IDS element

Independent monitoring

Identify the entities acting as independent monitors of the project (E.g. [free text]).

OC4IDS mapping

Project level:

Add an organization for the independent monitor and add 'independentMonitor' to its .roles array.

{
  "parties": [
    {
      "id": "1",
      "name": "Transparency International New Zealand",
      "roles": [
        "independentMonitor"
      ]
    }
  ]
}

CoST IDS element

Performance monitoring

Disclose Key Performance Indicators adopted by the project (E.g. [free text]).

OC4IDS mapping

See performance monitoring (climate finance).

CoST IDS element

Risk management plans

Disclose risk management plans prepared for the project (E.g. [Document]).

OC4IDS mapping

Project Level:

Add a project document and set its .documentType to 'riskProvisions'.

{
  "documents": [
    {
      "id": "1",
      "documentType": "riskProvisions",
      "url": "http://example.com/riskManagementPlan.pdf"
    }
  ]
}

CoST IDS element

Sustainable sub-sectors

Identify relevant sub-sectors related to the project scope. Select from a list (non-exhaustive):

Renewable energy
- Solar
- Wind
- Hydropower
- Biomass
- Geothermal
Water and wastewater management
Transport
- Low carbon transport
Natural resource management
- Flood protection

Free text to add not mentioned sub-sectors

OC4IDS mapping

Project Level:

Map to sector, using the open ProjectSector codelist.

{
  "sector": [
    "solar"
  ]
}

Sustainability modules¶

Economic and fiscal¶

Environment and climate¶

Climate finance¶

Social¶

Institutional¶