> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GHG Protocol Tutorial

> Calculate your organization's complete carbon footprint following GHG Protocol standards

Learn how to calculate your company's complete carbon footprint using the GHG Protocol Corporate Standard, the most widely used international accounting tool for measuring greenhouse gas emissions.

<Info>
  **Estimated time**: 2.5 hours

  **What you'll learn**:

  * Set up your company's organizational structure
  * Understand consolidation approaches for multi-entity organizations
  * Calculate Scope 1 (direct) emissions (30 minutes)
  * Calculate Scope 2 (indirect) emissions (30 minutes)
  * Calculate Scope 3 (indirect) emissions (1 hour)
  * Apply the appropriate calculation methods for different emission sources
</Info>

<Tip>
  **Planning your data integration?**

  Before diving into the API code, check the [Data Requirements](/guides/emissions/ghg-protocol-data-requirements) guide — a complete data dictionary showing every field Dcycle needs per emission category, where the data typically lives in your systems, and how to automate the integration. Share it with your IT/data engineering team.
</Tip>

## By Emission Scope

Understanding which Scope your emissions fall into helps with reporting. These are the three scopes as defined by the [GHG Protocol](https://ghgprotocol.org/corporate-standard):

### Scope 1: Direct Emissions

Scope 1 emissions are direct emissions from sources owned or controlled by your organization.

<AccordionGroup>
  <Accordion title="Company-Owned Vehicles">
    **API**: Vehicles & Vehicle Consumptions `NEW API (Recommended)`

    **Use for**: Fleet cars, delivery trucks, forklifts

    **Data needed**: Fuel type, quantity, vehicle specs

    [Mobile Combustion Tutorial →](/guides/emissions/ghg-protocol-step-2-scope-1#calculating-mobile-combustion)
  </Accordion>

  <Accordion title="Facility Fuel Combustion">
    **API**: Facilities & Invoices `LEGACY`

    **Use for**: Natural gas heating, diesel generators

    **Data needed**: Fuel type, consumption, facility location

    [Facilities Tutorial →](/guides/emissions/facilities-tutorial)
  </Accordion>

  <Accordion title="Waste Water Treatment">
    **API**: Waste Water Treatments `LEGACY`

    **Use for**: On-site treatment facilities

    **Data needed**: Daily treatment data, biogas production

    [API Reference →](/api-reference/waste-water-treatments/bulk-upload)
  </Accordion>
</AccordionGroup>

### Scope 2: Purchased Energy

Scope 2 emissions are indirect emissions from purchased energy. This includes electricity, heating, and cooling.

<AccordionGroup>
  <Accordion title="Electricity">
    **API**: Invoices `LEGACY`

    **Use for**: Office buildings, warehouses, factories

    **Data needed**: kWh consumed, grid location, invoice period

    [Scope 2 Emissions Tutorial →](/guides/emissions/ghg-protocol-step-3-scope-2)
  </Accordion>

  <Accordion title="District Heating/Cooling">
    **API**: Invoices `LEGACY`

    **Use for**: Purchased heat or cooling services

    **Data needed**: Energy consumed (kWh or MJ), supplier

    [Scope 2 Emissions Tutorial →](/guides/emissions/ghg-protocol-step-3-scope-2)
  </Accordion>
</AccordionGroup>

### Scope 3: Value Chain Emissions

Scope 3 emissions are indirect emissions from your value chain. This includes emissions from: purchased goods, services, capital goods, fuel and energy-related activities, upstream and downstream transportation, waste disposal, business travel, employee commuting, upstream and downstream leased assets, processing, use and end of life treatment of sold products, franchises and investments.
See more information in the [Technical Guidance for Calculating Scope 3 Emissions](https://ghgprotocol.org/sites/default/files/2023-03/Scope3_Calculation_Guidance_0%5B1%5D.pdf)..

<AccordionGroup>
  <Accordion title="1. Purchased Goods and Services">
    **API**: Purchases `LEGACY`

    **Use for**: Raw materials, components, office supplies, services

    **Data needed**: Product/service type, quantity, spend amount, supplier (optional)

    [Supply Chain Tutorial →](/guides/emissions/supply-chain-tutorial)
  </Accordion>

  <Accordion title="2. Capital Goods">
    **API**: Purchases `LEGACY`

    **Use for**: Equipment, machinery, buildings, vehicles (as assets)

    **Data needed**: Asset type, purchase value, supplier, asset lifetime

    Tutorial coming soon!
  </Accordion>

  <Accordion title="3. Fuel- and Energy-Related Activities">
    **API**: Invoices `LEGACY`

    **Use for**: Upstream emissions from extraction, production, and transportation of fuels (not included in Scope 1 or 2)

    **Data needed**: Fuel type, quantity, extraction/production location

    Tutorial coming soon!
  </Accordion>

  <Accordion title="4. Upstream Transportation and Distribution">
    **API**: Transport `LEGACY`

    **Use for**: Inbound shipments from suppliers, third-party logistics

    **Data needed**: Origin, destination, weight, transport mode, carrier

    Tutorial coming soon!
  </Accordion>

  <Accordion title="5. Waste Generated in Operations">
    **API**: Wastes `LEGACY`

    **Use for**: Recycling, landfill, incineration, composting

    **Data needed**: Waste type, quantity, disposal method, treatment facility

    Tutorial coming soon!
  </Accordion>

  <Accordion title="6. Business Travel">
    **API**: Business Travels `LEGACY`

    **Use for**: Employee travel by air, rail, car rental, hotel stays

    **Data needed**: Travel distance, mode of transport, accommodation nights

    Tutorial coming soon!
  </Accordion>

  <Accordion title="7. Employee Commuting">
    **API**: Employees `LEGACY`

    **Use for**: Employee travel to and from work

    **Data needed**: Commute distance, transport mode, number of employees, days worked

    Tutorial coming soon!
  </Accordion>

  <Accordion title="8. Upstream Leased Assets">
    **API**: `Coming soon!`

    **Use for**: Leased facilities, equipment, vehicles (operational control)

    **Data needed**: Asset type, lease period, energy consumption, fuel use

    Tutorial coming soon!
  </Accordion>

  <Accordion title="9. Downstream Transportation and Distribution">
    **API**: Transport `LEGACY`

    **Use for**: Outbound shipments from suppliers, third-party logistics

    **Data needed**: Origin, destination, weight, transport mode, carrier

    Tutorial coming soon!
  </Accordion>

  <Accordion title="10. Processing of Sold Products">
    **API**: `Coming soon!`

    **Use for**: Emissions from processing products sold by third parties

    **Data needed**: Product type, processing method, quantity processed

    Tutorial coming soon!
  </Accordion>

  <Accordion title="11. Use of Sold Products">
    **API**: Sold Products `NEW API`

    **Use for**: Emissions from end-user use of your products (e.g., energy consumption)

    **Data needed**: Product lifespan, energy consumption (electricity/fuel/water), units sold per country

    [Use of Sold Products Guide →](/guides/emissions/scope-3-category-11-use-of-sold-products)
  </Accordion>

  <Accordion title="12. End-of-Life Treatment of Sold Products">
    **API**: `Coming soon!`

    **Use for**: Disposal, recycling, incineration of products after use

    **Data needed**: Product type, disposal method, quantity disposed

    Tutorial coming soon!
  </Accordion>

  <Accordion title="13. Downstream Leased Assets">
    **API**: `Coming soon!`

    **Use for**: Assets leased to others (financial control)

    **Data needed**: Asset type, lease period, lessee energy consumption

    Tutorial coming soon!
  </Accordion>

  <Accordion title="14. Franchises">
    **API**: `Coming soon!`

    **Use for**: Emissions from franchise operations

    **Data needed**: Franchise locations, energy consumption, fuel use, operations data

    Tutorial coming soon!
  </Accordion>

  <Accordion title="15. Investments">
    **API**: `Coming soon!`

    **Use for**: Emissions from equity investments, debt investments, project finance

    **Data needed**: Investment type, investee emissions data, ownership percentage

    Tutorial coming soon!
  </Accordion>
</AccordionGroup>

## Tutorial Steps

Follow these steps to calculate your complete carbon footprint:

<CardGroup cols={2}>
  <Card title="Step 1: Set Up Your Company Structure" icon="building" href="/guides/emissions/ghg-protocol-step-1-company-structure">
    Create your organizational hierarchy and configure consolidation
  </Card>

  <Card title="Step 2: Calculate Scope 1 Emissions" icon="fire" href="/guides/emissions/ghg-protocol-step-2-scope-1">
    Track direct emissions from stationary and mobile combustion
  </Card>

  <Card title="Step 3: Calculate Scope 2 Emissions" icon="bolt" href="/guides/emissions/ghg-protocol-step-3-scope-2">
    Track indirect emissions from purchased energy
  </Card>

  <Card title="Step 4: Calculate Scope 3 Emissions" icon="boxes-stacked" href="/guides/emissions/ghg-protocol-step-4-scope-3">
    Track indirect emissions from your value chain
  </Card>
</CardGroup>