Skip to main content

​
Decarbonization Plan Tools

Query decarbonization plans — reduction targets, planned actions, baseline emissions, and organizational scope perimeters. Plans define emission reduction strategies against a baseline year, with targets specifying scope-level reduction percentages and actions tracking the concrete initiatives to achieve them.
Some targets and actions include ai_rationale and supporting_sources fields — these are generated by Leia, Dcycle’s AI assistant, when it proposes targets or actions. Manually created items will have these fields as null.

​
list_decarb_plans

List decarbonization plans for the organization, optionally filtered by project. Parameters:
ParameterTypeRequiredDefaultDescription
organization_idstringNodefault orgOrganization UUID
project_idstringNo—Filter by linked project UUID
Example response: 
{
  "id": "plan-1a2b3c4d-...",
  "project_id": "proj-5e6f7a8b-...",
  "status": "in_progress",
  "base_year": 2023,
  "target_year": 2030,
  "included_scopes": [1, 2, 3],
  "reporting_period_start_month": 1,
  "reporting_period_end_month": 12,
  "strategic_priorities": "Focus on fleet electrification and renewable energy procurement...",
  "budget": 500000,
  "currency_unit_id": "cur-1a2b3c4d-...",
  "config_review_status": "reviewed",
  "created_by": "u-1a2b3c4d-...",
  "report_file_id": null,
  "created_at": "2025-01-10T09:00:00",
  "updated_at": "2025-06-15T11:30:00"
}
Key response fields:
FieldDescription
statusPlan lifecycle: draft, in_progress, or completed
base_year / target_yearBaseline and target years for the reduction plan
included_scopesGHG Protocol scopes covered (e.g. [1, 2, 3])
strategic_prioritiesAI-generated strategic priority summary
budgetTotal allocated budget for the plan

​
get_decarb_plan

Get baseline emissions data for a decarbonization plan — the actual carbon footprint numbers used as the starting point for reduction calculations. Parameters:
ParameterTypeRequiredDefaultDescription
plan_idstringYes—UUID of the decarbonization plan
organization_idstringNodefault orgOrganization UUID
Example response: 
{
  "base_year": 2023,
  "included_scopes": [1, 2, 3],
  "approach": "operational",
  "site_tco2e": 1245.8,
  "group_tco2e": 3890.2
}
Key response fields:
FieldDescription
site_tco2ePrimary company (root org) standalone footprint in tCO2e
group_tco2eConsolidated footprint across the entire org perimeter
approachConsolidation approach (always operational)
site_tco2e and group_tco2e are null when the plan’s baseline year or included scopes are not yet configured.

​
list_decarb_targets

List reduction targets defined in a decarbonization plan. Each target specifies emission scopes, a reduction percentage, and a target year. Parameters:
ParameterTypeRequiredDefaultDescription
plan_idstringYes—UUID of the decarbonization plan
organization_idstringNodefault orgOrganization UUID
Example response: 
[
  {
    "id": "tgt-1a2b3c4d-...",
    "decarbonization_plan_id": "plan-1a2b3c4d-...",
    "organization_id": "a1b2c3d4-...",
    "scope": [1, 2],
    "target_type": "absolute",
    "base_year": 2023,
    "target_year": 2030,
    "base_emissions": 1245.8,
    "reduction_percentage": 42.0,
    "ai_rationale": "Based on SBTi 1.5°C pathway for the transport sector...",
    "supporting_sources": [{"type": "sbti", "reference": "1.5C-transport-2030"}],
    "status": "accepted",
    "created_at": "2025-01-15T10:00:00",
    "updated_at": "2025-02-01T14:30:00"
  }
]
Key response fields:
FieldDescription
scopeGHG scopes this target covers (e.g. [1, 2])
target_typeabsolute (total reduction) or intensity (per-unit reduction)
base_emissionsBaseline emissions in tCO2e for the target scopes
reduction_percentageTarget reduction (0–100), e.g. 42.0 = 42% reduction
statusproposed (by Leia), accepted, or rejected
ai_rationaleLeia’s reasoning for the proposed values (null if manual)

​
list_decarb_actions

List planned decarbonization actions and their progress. Actions are concrete initiatives linked to a specific target. Parameters:
ParameterTypeRequiredDefaultDescription
plan_idstringYes—UUID of the decarbonization plan
organization_idstringNodefault orgOrganization UUID
Example response: 
[
  {
    "id": "act-1a2b3c4d-...",
    "decarbonization_plan_id": "plan-1a2b3c4d-...",
    "decarbonization_target_id": "tgt-1a2b3c4d-...",
    "organization_id": "a1b2c3d4-...",
    "title": "Install solar panels at Madrid warehouse",
    "description": "150kW rooftop PV installation covering 60% of facility electricity demand",
    "scope": [2],
    "estimated_co2e_reduction": 85.3,
    "estimated_cost": 120000,
    "payback_period_months": 72,
    "npv": 45000,
    "priority": "medium_term",
    "status": "in_progress",
    "approval_status": "approved",
    "initiative_type": "electricity",
    "emission_source": "electricity",
    "saved_quantity": "960 MWh/year",
    "funding_amount": 80000,
    "annual_saving": 18000,
    "launch_date": "2025-06-01",
    "source": "leia",
    "ai_rationale": "Facility has 2000m² available roof space with south exposure...",
    "created_at": "2025-01-20T09:00:00",
    "updated_at": "2025-06-10T16:00:00"
  }
]
Key response fields:
FieldDescription
estimated_co2e_reductionExpected tCO2e saved per year
estimated_costEstimated implementation cost
priorityquick_win, medium_term, or long_term
statusproposed, accepted, in_progress, completed, or rejected
approval_statusFinance gate: not_submitted, pending, approved, or rejected
initiative_typeCategory: heating, electricity, fleet, operational, suppliers, or other
sourceOrigin: leia (AI-proposed), imported, or manual

​
get_decarb_perimeter

Get the organizational scope/perimeter snapshot for a decarbonization plan — which facilities, emission categories, and scopes are included. Parameters:
ParameterTypeRequiredDefaultDescription
plan_idstringYes—UUID of the decarbonization plan
organization_idstringNodefault orgOrganization UUID
Example response: 
{
  "plan_id": "plan-1a2b3c4d-...",
  "report_file_id": null,
  "snapshot": { ... },
  "generated_at": "2025-06-15T11:30:00",
  "status": "ready",
  "is_stale": false
}
Key response fields:
FieldDescription
snapshotStructured artifact snapshot defining the plan perimeter (facilities, scopes, categories)
statusArtifact state: draft, needs_input, ready, or stale
is_staleWhether the snapshot is outdated compared to current plan data
report_file_idFile ID of the generated PDF report (null if not yet generated)
Example prompts: 
"List our decarbonization plans"
"What are the baseline emissions for our decarbonization plan?"
"What reduction targets do we have and are they on track?"
"Show all planned actions and their progress"
"Which actions have been approved by finance?"
"What's the estimated CO2 reduction from our solar panel initiative?"
"Which facilities are included in our decarbonization scope?"

​
Workflow

  1. Discover plans — list_decarb_plans to see available plans and their status
  2. Check baselines — get_decarb_plan to see the actual carbon footprint baseline (site vs group)
  3. Review targets — list_decarb_targets to see scope-level reduction goals and whether they’re accepted
  4. Track actions — list_decarb_actions to check initiative progress, costs, and approval status
  5. Understand scope — get_decarb_perimeter to see which facilities and emission categories are included

Emissions

GHG emissions data that baselines are calculated from

Projects

Projects that decarbonization plans belong to

Facilities

Facilities included in the decarbonization perimeter