Skip to main content
Delivery Emissions is an independent Partner capability. It works the same whether your contribution method is loyalty_points or direct_contribution. Estimates are optional, educational Well-to-Wheel values—not environmental impact by themselves—and are not required to confirm a contribution.
When Delivery Emissions is disabled for your Partner, estimate and association operations return capability_disabled. When enabled, you may create estimates and optionally associate them with confirmed Loyalty or Direct contributions. The four supported combinations are in Contributions.

​
Operations

  • POST {baseUrl}/v1/emissions/estimates creates an estimate.
  • GET {baseUrl}/v1/emissions/estimates/{calculation_id} retrieves an estimate.
  • POST {baseUrl}/v1/impact-transactions/{transaction_id}/emissions-associations associates an estimate with a confirmed contribution.
Idempotency-Key is required when creating an estimate or association.

​
Calculation rules

Supported vehicle categories are:
  • motorcycle_gasoline
  • car_gasoline
Distance must satisfy 0 < distance_km <= 200 and may have no more than three decimal places. The Well-to-Wheel factors are:
  • motorcycle_gasoline: 143.23 gCO2e/km
  • car_gasoline: 207.51 gCO2e/km
The calculation is estimated_emissions_kgco2e = raw_emissions_gco2e / 1000. Display values use two decimals with round-half-up. Values below 0.01 are shown as <0.01, never 0.00.

​
Create an estimate

Send this JSON to POST {baseUrl}/v1/emissions/estimates:
A calculated estimate returns HTTP 201 with calculation_id, estimated_emissions_kgco2e, display fields, calculated_at, and expires_at (estimates expire after 24 hours). Methodology and emission-factor version identifiers are in the response for audit; see Create a delivery-emissions estimate.

​
Associate an estimate

After association, the immutable link snapshot is authoritative.
A successful association returns HTTP 201 with link metadata. Full fields are in Associate a late emissions estimate. Association failure is non-fatal: the contribution remains confirmed. Do not reverse customer value (points or payment) because of an association rejection. For a copy-paste estimate-then-associate flow, see Examples.