Getting Information About Your Carbon Footprint

You can get information about your carbon footprint, emission sources and categories.

Getting Information About Your Carbon Footprint Using Cockpit

  1. In the top right corner, click your initials.
    A drop-down menu appears.

  2. Hover over IconData My Data and click IconCarbonFootprint My Carbon Footprint
    Your carbon footprint estimate appears.

    The data presented is subject to change and is provided for informational and estimation purposes only.

  3. (optional) Specify:

    • Your account, a specific account, or all accounts.

    • A date range.

      The carbon footprint estimate takes into account the last 36 months starting from January 2024.

    • A measurement unit for the data (kgCO₂e ou tCO₂e).

      Your carbon footprint estimate for the specified account, date range, and unit appears.

      Switch on or off the Other view (table format) button to change how your estimate is displayed (chart or table).

Getting Information About Your Carbon Footprint Using OSC CLI

The ReadCO2EmissionAccount command gets information about the estimated carbon footprint of your account for the current Region within the specified time period.

Request sample
$ osc-cli api ReadCO2EmissionAccount --profile "default" \
    --FromMonth "2025-05-01" \
    --ToMonth "2025-06-01" \
    --Overall True

This command contains the following attributes that you need to specify:

  • FromMonth: The beginning of the time period, in ISO 8601 date format (for example, 2020-06-01). This value must correspond to the first day of the month and is included in the time period.

  • Overall: (optional) If false, returns only the CO2 emission of the specific account that sends the request. If true, returns either the overall CO2 emission of your paying account and all linked accounts (if the account that sends this request is a paying account) or returns nothing (if the account that sends this request is a linked account).
    Default: false.

  • ToMonth: The end of the time period, in ISO 8601 date format (for example, 2020-06-14). This value must correspond to the first day of the month and is excluded from the time period. It must be set to a later date than FromMonth.

The ReadCO2EmissionAccount command returns the following elements:

  • CO2EmissionEntries: The CO2 emission by month and account, for the specified request.

    • AccountId: The ID of the account associated with the consumption.

    • CategoryDistribution: The allocation of the Value among categories.

      • Category: The category of the resource (for example, storage).

      • Value: The total CO2 emissions for the category.

    • FactorDistribution: The allocation of the Value among factors.

      • Factor: The emission source (for example, hardware).

      • Value: The total CO2 emissions for the factor.

    • Month: The month associated with the CO2 emission entry.

    • PayingAccountId: The ID of the paying account related to the AccountId parameter.

    • Value: The total CO2 emissions for the Month and AccountId specified. This value corresponds to the sum of all entries in CategoryDistribution and FactorDistributionEntry.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

  • Unit: The unit of all the Value fields of the response, expressed in kgCO₂e.

  • Value: The total CO2 emission for the specified request.

Result sample
{
  "Unit": "KG",
  "Value": 2.469,
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "CO2EmissionEntries": [
    {
      "Value": 2.469,
      "AccountId": "123456789012",
      "CategoryDistribution": {
        "Value": 1.2345,
        "Category": "compute"
      },
      "Month": "2025-05-01T00:00:00.000Z",
      "PayingAccountId": "123456789012",
      "FactorDistribution": {
        "Value": 1.2345,
        "Factor": "electricity"
      }
    }
  ]
}

Related Page

Export to PDF