ESG - Report Emissions

Service:

Environmental Credit Service

API Version:

1.0

Report actual emissions for the ESG reporting period.

POST https://api.ecs.mcfs.microsoft.com/trial/v1/esgs/{esgScorecardId}/milestones/{esgMilestoneId}/reportingPeriods/{esgReportingPeriodId}/emissions

URI Parameters

Name	In	Required	Type	Description
esgMilestoneId	path	True	string uuid	ESG Milestone Id.
esgReportingPeriodId	path	True	string uuid	ESG reporting Period Id.
esgScorecardId	path	True	string uuid	ESG Scorecard Id.

Request Body

Media Types: "application/json-patch+json", "application/json", "application/*+json"

Name	Required	Type	Description
category	True	EmissionCategory
quantity	True	number	Gets or sets quantity of the ESGReportEmissionRequest.
scope	True	EmissionScope

Responses

Name	Type	Description
200 OK	ESGReportingPeriod	Success
201 Created		Returns the newly created item.
400 Bad Request		Validation failure.

Security

Bearer

Definitions

Name	Description
DurabilityRating
EmissionCategory
EmissionScope
ESGDemandSignal
ESGReportedEmission
ESGReportEmissionsRequest	ESG report emissions request model.
ESGReportingPeriod
ResourceStatus

DurabilityRating

Name	Type	Description
LongTerm	string
MediumTerm	string
ShortTerm	string

EmissionCategory

Name	Type	Description
DirectFacilities	string
DirectVehicles	string
IndirectBusinessTravel	string
IndirectCapitalGoods	string
IndirectDownstreamLeasedAssets	string
IndirectDownstreamTransportationAndDistribution	string
IndirectEmployeeCommuting	string
IndirectEndOfLifeTreatmentOfSoldProducts	string
IndirectFranchises	string
IndirectFuelAndEnergyRelatedActivities	string
IndirectInvestments	string
IndirectProcessingOfSoldProducts	string
IndirectPurchasedEnergy	string
IndirectPurchasedGoodsAndServices	string
IndirectUpstreamLeasedAssets	string
IndirectUpstreamTransportationAndDistribution	string
IndirectUseOfSoldProducts	string
IndirectWasteGeneratedInOperations	string

EmissionScope

Name	Type	Description
One	string
Three	string
Two	string

ESGDemandSignal

Name	Type	Description
biospherePercentageMix	integer
carbonReductionPercentage	integer
carbonRemovalPercentage	integer
countryOrRegionPreferences	string[]
durabilityPreference	DurabilityRating
geospherePercentageMix	integer
natureBasedPercentage	integer
originId	string
technologyBasedPercentage	integer

ESGReportedEmission

Name	Type	Description
category	EmissionCategory
originId	string
quantity	number
scope	EmissionScope
status	ResourceStatus

ESGReportEmissionsRequest

ESG report emissions request model.

Name	Type	Description
category	EmissionCategory
quantity	number	Gets or sets quantity of the ESGReportEmissionRequest.
scope	EmissionScope

ESGReportingPeriod

Name	Type	Description
actual	number
id	string
milestoneId	string
offsetPreferences	ESGDemandSignal
offsetsApplied	number
reportedEmission	ESGReportedEmission
reportingDate	string
retiredCredits	string[]

ResourceStatus

Name	Type	Description
Approved	string
Draft	string
Rejected	string
Resubmitted	string
ReturnedForEdits	string
Submitted	string