Nuclear and Gas fields in EU Taxonomy Portfolio API
Summary (What?)
Clarity AI has added Nuclear & Fossil Gas grouped metrics to the EU Taxonomy Portfolio API, available through a new optional parameter.
Clients can now retrieve portfolio-level aggregated values for:
- Nuclear-aligned activities
- Fossil Gas-aligned activities
- Non-Nuclear / Fossil Gas aligned activities
Business impact (Why?)
The addition of these fields allows access to Nuclear & Gas alignment metrics, calculated at the portfolio-level. These metrics may be used for EU Taxonomy reporting disclosures and the European ESG Template (EET).
Modules and Endpoints impacted (Where?)
List of endpoints by module impacted by this release:
| Module | Endpoints | Action (addition/removal/ deprecation/change) |
|---|---|---|
| EU Taxonomy | POST /public/portfolios/eu-taxonomy/{objective}/metric-by-id/async | Change |
New Features (How?)
1. Requesting Nuclear & Gas Metrics
Add the following optional parameter in the body:
"optionalColumns": ["GROUPED_NUCLEAR_FOSSIL_GAS"]
-
Returned JSON Structure
When the optional column is included, the API will return the metrics in a JSON format. For example:
"optionalColumns": {
"groupedNuclearAligned": {
"value": 1.16811905E-4,
"units": "%",
"metadata": "NONE"
},
"groupedFossilGasAligned": {
"value": 9.299271E-6,
"units": "%",
"metadata": "NONE"
},
"nonNuclearFossilGasAligned": {
"value": 1.2756963,
"units": "%",
"metadata": "NONE"
}
}
You can use the numeric value returned in the value field for the 3 fields, for the 3 metrics.
Metric Definitions
| Metric | Name | Description |
|---|---|---|
| GROUPED_NUCLEAR.ALIGNED | Grouped alignment of nuclear activities | Sum of all three (3) nuclear related activity alignment values, the activities are: 1) Construction of new nuclear power plants, 2) pre-commercial stages of advanced technologies to produce nuclear energy, and 3) electricity generation from nuclear energy in existing installations. |
| GROUPED_FOSSILGAS.ALIGNED | Grouped alignment of fossil gas activities | Sum of all three (3) fossil gas related activity alignment values, the activities are: 1) High-efficiency co-generation of heat/cool and power from fossil gaseous fuels, 2) electricity generation from fossil gaseous fuels, and 3) production of heat/cool from fossil gaseous fuels. |
| NON_NUCLEAR_FOSSILGAS.ALIGNED | Grouped alignment of non nuclear and fossil gas activities | Sum of the alignment values for the remaining activities belonging to the respective objective. |
How to configure the request
You can adjust the API parameters to extract the Nuclear & Gas metrics under different configurations, including:
- Different KPIs (turnover, capex, opex)
- With or without sovereign exposures
- Different EU Taxonomy objectives
Path parameter - EU Taxonomy Objective
Choose one of the following objectives in the path:
aggregationmitigationadaptationbiodiversitypollutionwatercircular
Query parameter - KPI
Select the KPI you want to retrieve:
turnovercapexopex
Body parameters
Select whether you want sovereigns included or excluded in the portfolio aggregation
"includeSovereignBonds": true"includeSovereignBonds": false
Include the new optional parameter in the body:
"optionalColumns": ["GROUPED_NUCLEAR_FOSSILGAS"]
This will allow you to retrieve Nuclear and Gas alignment metrics for your portfolio with different configurations that may be used for reporting purposes.
Example Request
POST /public/portfolios/<portfolioId>/eu-taxonomy/aggregation/steps-by-id?kpi=capex
Example body:
{
"optionalColumns": ["GROUPED_NUCLEAR_FOSSILGAS"],
"metricIds": [],
"includeSovereignBonds": true
}
This example request returns the three metrics for the CapEx KPI, including sovereign bonds in the aggregation.
Default behavior
If no optional parameter is included in the body → Grouped Nuclear & Gas metrics will not be returned in the JSON response.
Go-live date (When?)
3rd December 2025