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

Field Details
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 are:
  • 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 are:
  • 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 are:
  • 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 are:
  • 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.
The default value is '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.
Possible values are:
  • m2
  • sqft
The default value is '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 are:
  • 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.
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.
Possible values are:
  • m2
  • sqft
The default value is '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.