EU Taxonomy - Omnibus amendment across Universe & GIR APIs
Summary (What?)
Following the "Omnibus" amendment to the EU Taxonomy Disclosures Delegated Act (Article 7), Clarity AI is updating its EU Taxonomy APIs. The amendment changes how the Green Investment Ratio is calculated for Annex IV (asset managers) and Annex X (insurers), and introduces new reporting concepts that are now exposed through the API:
- Non-materiality, at overall and per-KPI level
- An Omnibus reporting template indicator, distinguishing data reported under the new template from data reported under the previous one
- A "no activities claimed" indicator
- Grouped nuclear and fossil-gas eligibility and alignment breakdowns
Three endpoints are affected, and none of them changes the behaviour of existing requests.
For the Organizations and Securities Universe APIs the change is additive: new optional columns, with no effect on requests that do not ask for them.
For the Green Investment Ratio API the post-Omnibus response is opt-in, controlled by a new omnibusEnabled body parameter. Without it, the endpoint returns exactly what it returns today. With omnibusEnabled: true, it returns the post-Omnibus response: 35 new fields, 25 fields recalculated under the new methodology, and 53 fields no longer present.
The pre-Omnibus response is retired on 1 April 2027.
The full list of GIR API fields affected, grouped by type of change, is available here. The comprehensive methodology document is here.
Business impact (Why?)
The Omnibus amendment changes both what has to be disclosed and how it is calculated: reported data only, voluntary reporters now counted, an additive denominator, and the new non-materiality and no-activities-claimed concepts. Exposing these metrics keeps clients able to complete their Annex IV and Annex X disclosures against the current rules without recalculating anything downstream.
What changes in the GIR figures when you opt in. The ratio is measured against the assets in scope of reporting rather than the full portfolio. Alignment and eligibility figures will generally rise, because voluntary reporters are now counted. Several of the sub-components that break down the denominator will show lower values, because everything is expressed relative to the covered portion of the portfolio.
Action required on the client side:
| Endpoint | Action required |
|---|---|
| Organizations Universe API | None. Add the new optional columns to your request when you want the new metrics. |
| Securities Universe API | None. Add the new optional columns to your request when you want the new metrics. |
| GIR API | None immediately. Existing requests keep working unchanged. Send omnibusEnabled: true when you are ready, and review the recalculated figures against your current feed before you switch. Migration must be complete by 1 April 2027, when the pre-Omnibus response is retired. |
Modules and Endpoints impacted (Where?)
| Module | Endpoint | Action |
|---|---|---|
| EU Taxonomy | POST /clarity/v1/public/organizations/eu-taxonomy/{objective}/metric-by-id/async | Addition of optional columns |
| EU Taxonomy | POST /clarity/v1/public/securities/eu-taxonomy/{objective}/metric-by-id/async | Addition of optional columns |
| EU Taxonomy | POST /clarity/v1/public/securities/eu-taxonomy/green-investment/ratio/metric-by-id/async | New omnibusEnabled body parameter; opt-in post-Omnibus response |
GIR API — scale of the change with omnibusEnabled: true
omnibusEnabled: true| Change type | Fields | What it means for you |
|---|---|---|
| New | 35 | Additional fields in the response: voluntary reporting, nuclear and fossil-gas breakdowns, non-material and no-activities-claimed counterparties. |
| Redefined | 25 | Same field names, values change under the new methodology. |
| Not returned | 53 | Absent from the post-Omnibus response. Still returned in the default response. |
| Unchanged | 29 | Continue exactly as today. |
New Features (How?)
1. New omnibusEnabled body parameter in the GIR API
omnibusEnabled body parameter in the GIR APIThe post-Omnibus response is opt-in. A new boolean body parameter controls which version of the response you receive:
omnibusEnabled | Response |
|---|---|
Omitted, empty or false | The pre-Omnibus response, exactly as today. Same fields, same values. |
true | The post-Omnibus response: 35 new fields, 25 recalculated fields, and 53 fields no longer returned. |
wide760{
"identifiers": ["..."],
"omnibusEnabled": true
}
Existing integrations need no change. Nothing disappears from the default response and no value moves unless you opt in. This parameter applies to the GIR endpoint only; the two Universe APIs are controlled by optionalColumns as described below.
2. New optional columns in the Universe APIs (organizations and securities)
Three new values are accepted in optionalColumns on both endpoints: NON_MATERIAL, OMNIBUS_TEMPLATE and NO_ACTIVITIES_CLAIMED.
In addition, GROUPED_NUCLEAR_FOSSILGAS is now accepted on the Organizations Universe API, where it was not previously available. It already exists on the Securities Universe API. On both endpoints it now returns three new .EXPOSED columns alongside the existing .ALIGNED ones.
wide760{
"metricIds": ["TOTAL", "AFFORESTATION"],
"kpi": "TURNOVER",
"optionalColumns": [
"DISCLOSURE", "NFRD", "METRIC_YEAR",
"NON_MATERIAL", "OMNIBUS_TEMPLATE",
"NO_ACTIVITIES_CLAIMED", "GROUPED_NUCLEAR_FOSSILGAS"
]
}
As with the existing optional columns, the exported column names carry no objective or KPI suffix: the objective is taken from the request path and the KPI from the kpi parameter (TURNOVER, CAPEX or OPEX), so the same column name returns the value for whichever objective and KPI you requested.
| Optional column | Columns exported | Type | Availability |
|---|---|---|---|
NON_MATERIAL | NON_MATERIAL | Percentage 0-100 | New on both endpoints. Aggregation objective only. |
OMNIBUS_TEMPLATE | OMNIBUS_TEMPLATE | TRUE / FALSE | New on both endpoints. All objectives. |
NO_ACTIVITIES_CLAIMED | NO_ACTIVITIES_CLAIMED | TRUE / FALSE | New on both endpoints. All objectives. |
GROUPED_NUCLEAR_FOSSILGAS | Existing: GROUPED_NUCLEAR.ALIGNED, GROUPED_FOSSILGAS.ALIGNED, NON_NUCLEAR_FOSSILGAS.ALIGNED. New: the .EXPOSED counterpart of each. | Percentage 0-100 | New on Organizations; already available on Securities. Aggregation, mitigation and adaptation objectives. |
NON_MATERIAL returns the non-material percentage for the requested KPI. Both endpoints return these values at organization level; in the Securities API they are resolved through the issuer behind each security.
3. New fields in the GIR API (omnibusEnabled: true)
omnibusEnabled: true)The GIR endpoint returns a single flat dataset rather than an objective- and KPI-parameterised one, so its field names carry the KPI explicitly, as they do today. Do not assume a field is named the same way across the three endpoints.
Security level (16 new fields):
- Enabling and transitional alignment across all objectives:
AGGREGATION_{TURNOVER, CAPEX}_ENABLING_ALIGNEDandAGGREGATION_{TURNOVER, CAPEX}_TRANSITION_ALIGNED - Grouped nuclear and fossil-gas eligibility and alignment:
AGGREGATION_{TURNOVER, CAPEX}_GROUPED_{NUCLEAR, FOSSILGAS}_{ELIGIBLE, ALIGNED}, each the sum of its three underlying activities - Non-materiality:
AGGREGATION_{TURNOVER, CAPEX}_NON_MATERIAL - The two Omnibus indicators:
EU_TAX_OMNIBUS_TEMPLATEandEU_TAX_NO_ACTIVITIES_CLAIMED
Fund level (19 new fields):
RATIO_ASSETS_COVERED, RATIO_VOLUNTARY, RATIO_AGGREGATION_{TURNOVER, CAPEX}_VOLUNTARY_ALIGNED, RATIO_AGGREGATION_{TURNOVER, CAPEX}_TRANSITION_ALIGNED, RATIO_AGGREGATION_{TURNOVER, CAPEX}_ENABLING_ALIGNED, RATIO_AGGREGATION_{TURNOVER, CAPEX}_{NUCLEAR, FOSSILGAS}_{ELIGIBLE, ALIGNED}, RATIO_{TURNOVER, CAPEX}_NON_MATERIAL_COUNTERPARTIES and RATIO_NO_ACTIVITIES_CLAIMED_COUNTERPARTIES.
Note the spelling FOSSILGAS, with no underscore. Every field is returned as a .VALUE and .META pair, except IDENTIFIER, which is a single column.
Enhancements (How?)
- Redefined GIR methodology. With
omnibusEnabled: true, fund-level ratio metrics are calculated against the assets in scope of reporting: voluntary reporters are included in numerator and denominator, and the denominator is additive, summing only CSRD issuers, voluntary reporters and use-of-proceeds instruments, so sovereigns, cash and derivatives fall out rather than being subtracted. Only reported data is used. 25 fields keep their names and change in value, includingRATIO_AGGREGATION_{TURNOVER, CAPEX}_{ELIGIBLE, ALIGNED}, the NFRD and other-counterparties alignment breakdowns, the per-objectiveRATIO_{OBJECTIVE}_{TURNOVER, CAPEX}_ALIGNEDfamily,RATIO_NFRD_FINANCIAL,RATIO_NFRD_NON_FINANCIALandRATIO_OTHER_COUNTERPARTIES. - Consistent nuclear and fossil-gas figures. These values were previously computed on request in each service. They are now ingested pre-calculated and served from stored values, so the API, the datafeeds and the web app return the same numbers.
- More stable GIR response times. GIR values are now read from a persisted store rather than loaded in memory in the backend, improving response-time stability on large requests.
Deprecated Endpoints or Features (How?)
53 fields are not present in the post-Omnibus response. They continue to be returned in the default response, so nothing breaks until you opt in. They are retired for good on 1 April 2027, when the pre-Omnibus response is withdrawn.
They are not all fund-level. 30 are fund-level RATIO_* fields and 23 are security-level, which is easy to overlook — among them FLAG_EU and FLAG_DERIVATIVE, two flags commonly used client-side for filtering, and the per-objective ELIGIBLE, ENABLING_ALIGNED and TRANSITION_ALIGNED fields.
| Deprecated | Replacement |
|---|---|
FLAG_EU | None. EU domicile no longer determines inclusion in the denominator. |
FLAG_DERIVATIVE, RATIO_DERIVATIVE | None. Derivatives fall outside the additive denominator. |
RATIO_AGGREGATION_ELIGIBLE_NOT_ALIGNED, RATIO_AGGREGATION_NON_ELIGIBLE | Derive from RATIO_AGGREGATION_{KPI}_ELIGIBLE and RATIO_AGGREGATION_{KPI}_ALIGNED |
RATIO_NON_NFRD_FINANCIAL, RATIO_NON_NFRD_NON_FINANCIAL, RATIO_NON_NFRD_NON_EU_FINANCIAL, RATIO_NON_NFRD_NON_EU_NON_FINANCIAL | RATIO_VOLUNTARY, RATIO_OTHER_COUNTERPARTIES |
Per-objective {OBJECTIVE}_{KPI}_ELIGIBLE and RATIO_{OBJECTIVE}_{KPI}_ELIGIBLE | AGGREGATION_{KPI}_ELIGIBLE, RATIO_AGGREGATION_{KPI}_ELIGIBLE |
Per-objective ..._ENABLING_ALIGNED and ..._TRANSITION_ALIGNED | AGGREGATION_{KPI}_{ENABLING, TRANSITION}_ALIGNED, RATIO_AGGREGATION_{KPI}_{ENABLING, TRANSITION}_ALIGNED |
RATIO_NON_SOVEREIGNS is retained and unchanged. The full field list is the authoritative reference for all 53.
Annex XII deprecation is tracked separately (EUT-5657) and will be communicated in its own release note.
Known Issues (How?)
- Zero-coverage funds: with
omnibusEnabled: true, a fund with no assets in scope of reporting returnsRATIO_ASSETS_COVERED = 0andNULLnumerator metrics. This is by design.
Go-live date (When?)
ETA: 22 September 2026
Transition timeline (When?)
| Event | Description | Date |
|---|---|---|
| Announcement | Client communication issued (Omnibus September 2026 update and 1:1 follow-ups) | 24 July 2026 |
| Release | New optional columns live in the Universe APIs. Post-Omnibus GIR response available via omnibusEnabled; the default GIR response is unchanged | 22 September 2026 |
| End of Support | The pre-Omnibus GIR response is retired. omnibusEnabled no longer controls the response and the post-Omnibus fields become the only ones returned | 1 April 2027 |
