CSRD Tools

Read and build CSRD (Corporate Sustainability Reporting Directive) compliance data — double materiality assessments, IROs (Impacts, Risks and Opportunities), and their scores. These tools support ESRS reporting workflows.

CSRD tools cover the governance and compliance pillar. For environmental emissions use the Emissions tools, and for social workforce data use the Workforce tools. To plan against a finished assessment, see Goals & Actions.

Bulk loading a whole assessment from a spreadsheet is not available here — it needs elevated permissions and a file on disk. Use dcy csrd dm upload and dcy csrd iro upload for that.

`list_double_materiality`

List CSRD Double Materiality assessment topics with their scores. Each topic represents a sustainability matter assessed for both impact materiality and financial materiality — the core of CSRD/ESRS reporting. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	Organization UUID
`year`	integer	No	—	Filter by assessment year
`lang`	string	No	EN	Language for topic names (`EN` or `ES`)
`material`	boolean	No	—	Filter by materiality status (`true` = material only)
`page`	integer	No	1	Page number
`size`	integer	No	50	Results per page (max 200)

Example response:

{
  "items": [
    {
      "id": "a1b2c3d4-...",
      "csrd_sustainability_matter_id": "b2c3d4e5-...",
      "esg_category": "environmental",
      "topic": "Climate change",
      "name": "GHG emissions",
      "material": true,
      "being_measured": true,
      "impact_score": 85.0,
      "financial_score": 70.0
    }
  ],
  "total": 42,
  "page": 1,
  "size": 50
}

Key response fields:

Field	Description
`esg_category`	ESG pillar: `environmental`, `social`, or `governance`
`topic`	ESRS topic group (e.g. “Climate change”, “Own workforce”)
`name`	Specific sustainability matter name
`material`	Whether this topic is considered material for the organization
`being_measured`	Whether data collection is active for this topic
`impact_score`	Impact materiality score (0–100)
`financial_score`	Financial materiality score (0–100)

Example prompts:

"Show all material sustainability topics"
"What are our double materiality scores for 2025?"
"Which environmental topics are considered material?"
"List all topics with an impact score above 70"

`update_dm_scores`

Score one sustainability matter. This is how an assessment gets built. Parameters:

Parameter	Type	Required	Description
`dm_record_id`	string	Yes	The record’s own `id` from `list_double_materiality`
`impact_score`	number	No	Impact materiality, 0–100
`financial_score`	number	No	Financial materiality, 0–100
`being_measured`	boolean	No	Whether data collection is active
`organization_id`	string	No	Organization UUID

dm_record_id is the assessment record’s id, not csrd_sustainability_matter_id. Both come back from list_double_materiality; the matter id belongs to the shared catalogue and is what an IRO hangs off, while the record id is this organization’s assessment of it for one year.

Materiality is derived, never set. The API marks a matter material when either score reaches the threshold, and clears being_measured whenever the scores move. There is no material parameter.

Only the fields you pass are sent, so scoring one axis leaves the other untouched. At least one of the three is required. Example prompts:

"Score climate change mitigation 82 on impact and 79 on financial"
"Mark water use as already being measured"

`list_csrd_iros`

List IROs (Impacts, Risks and Opportunities) linked to sustainability matters from the Double Materiality assessment. Each IRO describes a specific impact, risk, or opportunity identified during the CSRD assessment process. Parameters:

Parameter	Type	Required	Default	Description
`year`	integer	Yes	—	Assessment year
`organization_id`	string	No	default org	Organization UUID
`page`	integer	No	1	Page number
`size`	integer	No	50	Results per page (max 200)

Example response:

{
  "items": [
    {
      "id": "f1e2d3c4-...",
      "sustainability_matter_id": "a1b2c3d4-...",
      "description": "Physical risks from extreme weather events affecting facilities",
      "type": "risk",
      "measurement_campaign_id": "e5f6a7b8-...",
      "score": 72
    }
  ],
  "total": 15,
  "page": 1,
  "size": 50
}

Key response fields:

Field	Description
`sustainability_matter_id`	Links to a Double Materiality topic
`description`	Free-text description of the IRO
`type`	IRO classification: `impact`, `risk`, or `opportunity`
`measurement_campaign_id`	Links to the measurement campaign
`score`	Assessment score for this IRO

Example prompts:

"List all IROs for 2025"
"What risks were identified in this year's CSRD assessment?"
"Show opportunities linked to our material topics"
"What is the highest-scored impact?"

`create_csrd_iro`

Create an IRO against a sustainability matter — what the matter actually means for this business. Parameters:

Parameter	Type	Required	Description
`year`	integer	Yes	Assessment year — picks the measurement campaign
`sustainability_matter_id`	string	Yes	`csrd_sustainability_matter_id` from `list_double_materiality`
`description`	string	Yes	What the impact, risk or opportunity is
`iro_type`	string	Yes	See below
`score`	integer	Yes	Severity or magnitude, 0–100
`organization_id`	string	No	Organization UUID

Valid iro_type values:


`current_positive_impact`	`potential_positive_impact`
`current_negative_impact`	`potential_negative_impact`
`risk`	`opportunity`

An IRO can hang off any matter in the catalogue, whether or not it came out material.

Example prompts:

"Add a risk to climate adaptation: heat waves interrupt the southern sites, score 65"
"Create an opportunity on energy for rooftop solar"

`update_csrd_iro`

Replace an IRO.

Parameter	Type	Required	Description
`iro_id`	string	Yes	IRO UUID
`sustainability_matter_id`	string	Yes	The matter it hangs off
`description`	string	Yes	What the impact, risk or opportunity is
`iro_type`	string	Yes	As above
`score`	integer	Yes	0–100
`organization_id`	string	No	Organization UUID

This replaces the record rather than editing part of it — the API requires every field. Read the current values with list_csrd_iros first; anything supplied from memory instead will silently overwrite what is stored.

`delete_csrd_iro`

Delete an IRO. Goals and actions that addressed it keep existing; they simply stop pointing at it.

Parameter	Type	Required	Description
`iro_id`	string	Yes	IRO UUID
`organization_id`	string	No	Organization UUID

`get_csrd_output_data`

Get all ESRS disclosure requirements with their datapoints, grouped by disclosure requirement code (e.g. E1-1, S1-6, G1-1). Each requirement includes reporting status, measurement state, and individual datapoints. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	Organization UUID
`start_date`	string	No	—	Filter from date (`YYYY-MM-DD`)
`end_date`	string	No	—	Filter to date (`YYYY-MM-DD`)

Example response:

{
  "E1-1": {
    "disclosure_requirement_code": "E1-1",
    "dr_name": "Transition plan for climate change mitigation",
    "dr_type": "disclosure",
    "esg_category": "environmental",
    "esg_subcategory": "climate_change",
    "report": true,
    "measuring": "complete",
    "datapoints": [
      {
        "id": "a1b2c3d4-...",
        "datapoint_id": "E1-1-01",
        "name_dcycle": "GHG emission reduction targets",
        "csrd_data_type": "quantitative",
        "mandatory_by": ["ESRS E1"],
        "mdr_datapoint": false,
        "calculating": false,
        "report": true,
        "measuring": "complete"
      }
    ]
  }
}

Example prompts:

"Show all CSRD disclosure requirements"
"Which E1 climate disclosures are we reporting?"
"What datapoints are still not being measured?"

`list_measurement_campaigns`

List measurement campaigns for an organization. Each campaign defines a reporting period used to collect CSRD/ESRS data — IROs, survey results, and output data are linked to a specific campaign. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	Organization UUID

Example response:

[
  {
    "id": "e5f6a7b8-...",
    "start_date": "2025-01-01",
    "end_date": "2025-12-31"
  },
  {
    "id": "b8a7f6e5-...",
    "start_date": "2024-01-01",
    "end_date": "2024-12-31"
  }
]

Example prompts:

"List all measurement campaigns"
"What reporting periods have been set up?"
"Which campaign covers 2025?"

`list_csrd_survey_results`

List CSRD survey results — stakeholder materiality scores. Each result represents a stakeholder’s assessment of a sustainability matter’s impact and financial materiality, linked to a measurement campaign. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	Organization UUID
`year`	integer	No	—	Filter by assessment year
`lang`	string	No	EN	Language for topic names (`EN` or `ES`)
`page`	integer	No	1	Page number
`size`	integer	No	50	Results per page (max 200)

Example response:

{
  "items": [
    {
      "id": "d4e5f6a7-...",
      "organization_measurement_campaign_id": "e5f6a7b8-...",
      "csrd_sustainability_matter_id": "a1b2c3d4-...",
      "organization_id": "org-uuid-...",
      "impact_score": 75.0,
      "finance_score": 60.0,
      "esg_category": "environmental",
      "topic": "Climate change",
      "name": "GHG emissions"
    }
  ],
  "total": 120,
  "page": 1,
  "size": 50
}

Key response fields:

Field	Description
`organization_measurement_campaign_id`	Links to the measurement campaign
`csrd_sustainability_matter_id`	Links to the sustainability matter
`impact_score`	Stakeholder’s impact materiality score (0–100)
`finance_score`	Stakeholder’s financial materiality score (0–100)
`esg_category`	ESG pillar: `environmental`, `social`, or `governance`
`topic`	ESRS topic group
`name`	Specific sustainability matter name

Example prompts:

"Show all CSRD survey results for 2025"
"What are the average stakeholder scores by ESG category?"
"Which topics did stakeholders rate highest for financial materiality?"

Workflow

Reading an assessment

List campaigns — list_measurement_campaigns to see available reporting periods
Assess materiality — list_double_materiality to see which topics are material
Review IROs — list_csrd_iros to see impacts, risks, and opportunities per topic
Stakeholder input — list_csrd_survey_results to see how stakeholders scored each topic
Check disclosures — get_csrd_output_data to see which requirements are being reported
Check emissions — Use get_greenhouse_gas_emissions for environmental data on material topics

Building one

Read the catalogue — list_double_materiality for the year, to get each record’s id and its csrd_sustainability_matter_id
Score the matters — update_dm_scores per record; materiality falls out of the scores
Confirm what came out material — list_double_materiality with material: true
Write the IROs — create_csrd_iro against the matters that matter
Plan the work — create_ms_goal and create_ms_action from the Goals & Actions tools, linked back to those IROs
Find what is unaddressed — list_ms_source_links with source_type: "iro"

Emissions

GHG emissions data for environmental materiality topics

Workforce

Own workforce data for social materiality topics

Goals & Actions

Targets and work planned against these IROs

Organizations

Organization hierarchy for group-level assessments

Getting Started

Tools Reference

Reference Data

`list_double_materiality`

`update_dm_scores`

`list_csrd_iros`

`create_csrd_iro`

`update_csrd_iro`

`delete_csrd_iro`

`get_csrd_output_data`

`list_measurement_campaigns`

`list_csrd_survey_results`

Workflow

Emissions

Workforce

Goals & Actions

Organizations

​list_double_materiality

​update_dm_scores

​list_csrd_iros

​create_csrd_iro

​update_csrd_iro

​delete_csrd_iro

​get_csrd_output_data

​list_measurement_campaigns

​list_csrd_survey_results

​Workflow

​Related

Emissions

Workforce

Goals & Actions

Organizations

`list_double_materiality`

`update_dm_scores`

`list_csrd_iros`

`create_csrd_iro`

`update_csrd_iro`

`delete_csrd_iro`

`get_csrd_output_data`

`list_measurement_campaigns`

`list_csrd_survey_results`

Workflow

Related