StnryAssetCrbnFtprnt

Represents the total carbon emissions and other environmental attributes from stationary assets. Carbon footprint quantifies the effect of atmospheric warming, which is represented in metric tonnes of carbon dioxide equivalent (tCO₂e). Additionally, it also quantifies various aspects of the energy performance of the asset. This object is available in API version 54.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

AllocatedRenewableEnergyInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total renewable energy allocated to this carbon footprint record.

AllocationStatus

Type: picklist
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The allocation status of renewable energy for this carbon footprint record.
Possible values:
- Allocated
- In Progress
- Not Allocated

AnnualEmssnInventoryId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The emissions inventory record for a particular year that’s related to the stationary asset carbon footprint record. This is a relationship field.
Relationship Name: AnnualEmssnInventory
Relationship Type: Lookup
Refers To: AnnualEmssnInventory

AuditApprovalStatus

Type: picklist
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The status of audit approval of this carbon footprint record.
Possible values:
- Approved
- Pending Approval

AvgDataCenterPue

Type: double
Properties: Filter, Nillable, Sort
Description: The average power usage effectiveness of the data center that’s calculated based on all the associated energy use records. This value is calculated by dividing the data center’s total electricity consumption value by the data center computing equipment’s total electricity consumption value.

AvgMonthlyElectrCnsmpInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The average monthly-normalized electricity consumption in kWh. This value is calculated based on the electricity consumption values across all stationary asset energy use records associated with this carbon footprint record.

BuildingEnergyIntensityId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The building energy intensity record that can be used to fill energy consumption data gaps. This is a relationship field.
Relationship Name: BuildingEnergyIntensity
Relationship Type: Lookup
Refers To: BldgEnrgyIntensity

CarbonInventoryRecordCount

Type: double
Properties: Filter, Nillable, Sort
Description: The number of energy use records associated with this carbon footprint record.

Ch4EmissionsInKg

Type: double
Properties: Filter, Nillable, Sort
Description: The CH4 emissions that are calculated for this energy use record.

Co2EmissionsInKg

Type: double
Properties: Filter, Nillable, Sort
Description: The CO2 emissions that are calculated for this energy use record.

DataCtrItDieselCnsmpIntensity

Type: double
Properties: Filter, Nillable, Sort
Description: The diesel consumption intensity of the data center’s computing equipment.

DataGapStatus

Type: picklist
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The status of filling the energy consumption data gaps for this carbon footprint record.
Possible values:
- Complete
- Data Gaps Identified
- Pending Review

ElectricityIntensityVarPct

Type: percent
Properties: Filter, Nillable, Sort
Description: The percentage difference between the regional electricity consumption intensity of the carbon footprint and the electricity consumption intensity of the associated carbon footprint item.

EndDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date until when the values of this carbon footprint record are valid.

EnrgyCnsmpIntensityInKbtuM2

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity of all the associated energy use records in kBtu per square meter.

EnrgyCnsmpIntensityInKbtuSqft

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity of all the associated energy use records in kBtu per square foot.

EnrgyCnsmpIntensityInKwhM2

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity of all the associated energy use records in kWh per square meter.

EnrgyCnsmpIntensityInKwhSqft

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity of all the associated energy use records in kWh per square foot.

EnrgyIntensityVariancePct

Type: percent
Properties: Filter, Nillable, Sort
Description: The percentage difference between the electricity consumption intensity and the regional electricity consumption intensity of the carbon footprint

FootprintStage

Type: picklist
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The workflow stage for this carbon footprint record.
Possible values:
- Completed
- Data Collection
- Data Gap Filling
- Data Validation
- Emission Source Confirmation
- External Audit
- Internal Audit
- Renewable Energy Allocation

IsRecordLocked

Type: boolean
Properties: Defaulted on create, Filter, Group, Sort
Description: Indicates whether the stationary asset carbon footprint record and the associated energy use records are locked for editing.
Default value: false

LastReferencedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp for when the current user last viewed a record related to this record.

LastViewedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed.

LocBasedElectrFrOthrFuelInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from other fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromBiomassInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from biomass for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromCoalInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from coal for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromGasInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from gas for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromHydroInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from hydroelectric energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromNuclearInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from nuclear power for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromOilInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from oil for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromSolarInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from solar photovoltaic energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBasedElectrFromWindInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from wind for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBsdElectrFrGeothermalInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from geothermal energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.

LocBsdElectrOthrFossilFuelKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from other fossil fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.

MaxVarianceAboveAvgElectrCnsmp

Type: percent
Properties: Filter, Nillable, Sort
Description: The difference between the highest normalized monthly electricity consumption and the average monthly electricity consumption of all the associated energy use records

MaxVarianceBelowAvgElectrCnsmp

Type: percent
Properties: Filter, Nillable, Sort
Description: The difference between the lowest normalized monthly electricity consumption and the average monthly electricity consumption of all the associated energy use records

MktBsdElectrFrBiomassInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from biomass for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrFromCoalInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from coal for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrGasInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from gas for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrGeothermalInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from geothermal energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrHydroInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from hydroelectric energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrNuclearInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from nuclear power for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrOilInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from oil for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrOthrFuelInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from other fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrSolarInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from solar photovoltaic energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrFrWindInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from wind for all the associated energy use records, that’s used to calculate emissions using the market-based method.

MktBsdElectrOthrFossilFuelKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total electricity generated from other fossil fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.

N2oEmissionsInKg

Type: double
Properties: Filter, Nillable, Sort
Description: The N2O emissions that are calculated for this energy use record.

Name

Type: string
Properties: Create, Filter, Group, idLookup, Sort, Update
Description: The name for this carbon footprint record.

OccupiedFloorArea

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The value to override the occupied floor area of the associated stationary asset environmental source.

OccupiedFloorAreaUnit

Type: picklist
Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The unit of measure for the occupied floor area of the associated stationary asset environmental source.
Default value: sqft
Possible values:
- m2
- sqft

OwnerId

Type: reference
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: The ID of the user who owns this record. This is a polymorphic relationship field.
Relationship Name: Owner
Relationship Type: Lookup
Refers To: Group, User

PrevYrAnnlCarbonFootprintId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The previous year’s carbon footprint record for the associated stationary asset environmental source. This is a relationship field.
Relationship Name: PrevYrAnnlCarbonFootprint
Relationship Type: Lookup
Refers To: StnryAssetCrbnFtprnt

PrevYrDataCenterPue

Type: double
Properties: Filter, Nillable, Sort
Description: The data center’s power usage effectiveness for the previous year.

PrevYrEnrgyIntensityKbtuM2

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity for the previous year in kBtu per square meter.

PrevYrEnrgyIntensityKbtuSqft

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity for the previous year in kBtu per square foot.

PrevYrEnrgyIntensityKwhM2

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity for the previous year in kWh per square meter.

PrevYrEnrgyIntensityKwhSqft

Type: double
Properties: Filter, Nillable, Sort
Description: The energy consumption intensity for the previous year in kWh per square foot.

RegionalBldgEnergyIntensityId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The building energy intensity record containing the standard building energy intensity data from a government source. This is a relationship field.
Relationship Name: RegionalBldgEnergyIntensity
Relationship Type: Lookup
Refers To: BldgEnrgyIntensity

ReportingDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date when this carbon footprint record data is due to be sent to a reporting body.

ReportingYear

Type: picklist
Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The year in which this carbon footprint record data is due to be sent to a reporting body.
Possible values:
- 2000
- 2001
- 2002
- 2003
- 2004
- 2005
- 2006
- 2007
- 2008
- 2009
- 2010
- 2011
- 2012
- 2013
- 2014
- 2015
- 2016
- 2017
- 2018
- 2019
- 2020
- 2021
- 2022
- 2023
- 2024
- 2025
- 2026
- 2027
- 2028
- 2029
- 2030
- 2031
- 2032
- 2033
- 2034
- 2035
- 2036
- 2037
- 2038
- 2039
- 2040

RgnlElectrCnsmpIntensity

Type: double
Properties: Filter, Nillable, Sort
Description: The total regional electricity consumption intensity from the associated regional building energy intensity record in kWh per square foot.

RgnlEnrgyCnsmpIntensity

Type: double
Properties: Filter, Nillable, Sort
Description: The total regional electricity consumption intensity from the associated regional building energy intensity record in kBtu per square foot.

Scope3EmssnDnstrmLsdAst

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from downstream leased assets that are included in category 13 of the related carbon footprint record or the override value.

Scp3EmssnCptlGoods

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the production of capital goods that are included in category 2 of the related carbon footprint record or the override value.

Scp3EmssnEmpCommute

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the employee commute that’s included in category 7 of the related carbon footprint record or the override values.

Scp3EmssnFranchises

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the operation of franchises that are included in category 14 of the related carbon footprint record or the override value.

Scp3EmssnInvestments

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from investment that are included in category 15 of the related carbon footprint record or the override value.

Scp3EmssnProcSoldPrdct

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the processing of sold products that are included in category 10 of the related carbon footprint record or the override value.

Scp3EmssnPurchGoodsSrvcs

Type: double
Properties: Filter, Nillable, Sort
Description: The scope 3 emissions from the production of purchased goods and services that are ncluded in category 1 associated with the carbon footprint record or the relevant override value.

Scp3EmssnUpstrmLsdAst

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the operation of upstream leased assets that are included in category 8 of the related carbon footprint record or the override value.

Scp3EmssnUseOfSoldPrdct

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the use of sold products and services that are included in category 11 of the related carbon footprint record or the override value.

Scp3EmssnWstGenInOper

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the treatment and disposal of generated waste that is included in category 5 of the related carbon footprint record or the override value.

Scp3EndLifeTreatSoldPrdct

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the end-of-life treatment of sold products that are included in category 12 of the related carbon footprint record or the override value.

Scp3FuelEnrgyRelaActv

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from the production of fuel and energy that are included in category 3 of the related carbon footprint record or the override values.

Scp3MktEmssnFuelEnrgy

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 market-based emissions, measured in metric tons, from producing fuel and energy. These emissions are included in the category 3 of the related carbon footprint record or the override values.

Scp3UncategorizedEmssn

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from uncategorized sources in the related carbon footprint record or the override value.

StartDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date from when the values of this carbon footprint record are valid.

StnryAssetEnvrSrcId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The stationary asset environmental source record associated with this carbon footprint record. This is a relationship field.
Relationship Name: StnryAssetEnvrSrc
Relationship Type: Lookup
Refers To: StnryAssetEnvrSrc

SuplScope1Emissions

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 1 emissions value that’s added to the calculated total scope 1 emissions value.

SuplScope2LocationBasedEmssn

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 2 location-based emissions value that’s added to the calculated total scope 2 location-based emissions value.

SuplScope2MarketBasedEmssn

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 2 market-based emissions value that’s added to the calculated total scope 2 market-based emissions value.

SuplScope3DnstrmEmissions

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 3 emissions value from downstream activities that’s added to the calculated total scope 3 emissions value.

SuplScope3UpstrmEmissions

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 3 emissions value from upstream activities that’s added to the calculated total scope 3 emissions value.

TotBldgIndirectEnrgyCnsmpInMwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total consumption of energy generated from electricity, heat, cooling, and steam. The consumption value excludes energy generated from other building fuels.

TotEnergyConsumptionInGj

Type: double
Properties: Filter, Nillable, Sort
Description: The total energy consumption from all the energy sources and associated energy use records converted from kWh to gigajoules.

TotEnergyConsumptionInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total energy consumption from all the energy sources and associated energy use records.

TotEnergyConsumptionInMwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total energy consumption from all the energy sources and associated energy use records converted from kWh to MWh.

TotRnwlEnrgyExclHydroInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total renewable energy excluding hydroelectric energy. This value is calculated based on the market-based grid mix values and allocated renewable energy values.

TotRnwlEnrgyExclHydroPct

Type: percent
Properties: Filter, Nillable, Sort
Description: The percentage of total renewable energy excluding hydroelectric energy out of the total electricity consumption.

TotScope1EmissionsInTco2e

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 1 emissions from all the associated energy use records and supplemental emissions.

TotScope2LocBasedEmissions

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 2 emissions value that’s calculated based on the location-based data of grid emissions.

TotScope2MktBasedEmissions

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 2 emissions value that’s calculated based on the utility-provided emissions data and allocated renewable energy.

TotalFloorArea

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The value to override the total floor area of the associated stationary asset environmental source.

TotalFloorAreaUnit

Type: picklist
Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The unit of measure for the total floor area of the associated stationary asset environmental source.
Default value: sqft
Possible values:
- m2
- sqft

TotalRenewableEnergyInKwh

Type: double
Properties: Filter, Nillable, Sort
Description: The total renewable energy in kWh that’s calculated based on the market-based grid mix values and the allocated renewable energy value.

TotalRenewableEnergyPct

Type: percent
Properties: Filter, Nillable, Sort
Description: The percentage of total renewable energy out of the total electricity consumption.

TotalScp3DnstrmEmissions

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from downstream activities. This value is calculated based on the scope 3 downstream emission values and supplemental scope 3 downstream emission values of all the associated energy use records.

TotalScp3UpstrmEmissions

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 3 emissions from upstream activities. This value is calculated based on the scope 3 upstream emission values and supplemental scope 3 upstream emission values of all the associated energy use records.

YearOverYearPueVariancePct

Type: percent
Properties: Filter, Nillable, Sort
Description: The percentage difference of the data center’s power usage effectiveness in the current year’s carbon footprint and the previous year’s carbon footprint.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

StnryAssetCrbnFtprntChangeEvent (API Version 63.0): Change events are available for the object.
StnryAssetCrbnFtprntFeed: Feed tracking is available for the object.
StnryAssetCrbnFtprntHistory: History is available for tracked fields of the object.
StnryAssetCrbnFtprntShare: Sharing is available for the object.