Quotes
Calculate an order quote by mass
POST to /v1/orders/by-mass/quoteThis endpoint does not create an order.It processes the order as if it were placed, returning estimated cost and bundles allocations.Request body
oneOf
Response
currencystringrequired
Currency code
estimated_quantitystringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated quantity (tonnes CO2).
May be lower than requested_quantity.
estimated_offset_coststringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated offset cost
Unit: order quote currency
estimated_total_coststringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated total cost inclusive of Lune fees.
Unit: order quote currency
estimated_commissionstringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated commission
bundlesarrayrequired
Bundles included in the quote including quantity and cost breakdown.
object
bundle_idstringrequired
The bundle's unique identifier
bundle_namestringrequired
The bundle's name
primary_imagestring
A bundle's image URL
quantitystringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Quantity for the specific bundle (tonnes CO2)
unit_pricestringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Bundle unit price per tonne CO2
Unit: order currency
gross_unit_pricestringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Bundle unit price per tonne CO2 inclusive of fees.
Unit: order currency
offset_coststringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
The bundle's net offset cost being purchased.
Unit: order currency
insufficient_available_quantitybooleanrequirednullable
If true, there is no inventory necessary to fully satisfy the order for this bundle.
requested_quantitystringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Requested quantity for the specific bundle (tonnes CO2).
requested_quantity may be returned as part of an emission estimate response, in which case this property contains the equivalent value as the mass property.
requested_valuestringrequirednullable
Pattern: ^[0-9]+(\.[0-9]+)?$
Requested value of CO2 offsets to purchase in the account's currency.
Errors
This API operation can return the following errors:400api_version_invalid400bundle_selection_ratios_invalid400bundle_selection_bundle_invalid400order_value_invalid400bundle_id_invalid400id_invalid400distance_invalid400test_account_name_update_disallowed400bundle_selection_ratios_invalid_format400address_not_foundCalculate an order quote by value
POST to /v1/orders/by-value/quoteThis endpoint does not create an order.It processes the order as if it were placed, returning estimated cost and bundles allocations.Request body
valuestringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Maximum price of CO2 offsets to purchase (in the account's currency).
value must not be lower than the currency's minimum unit.
bundle_selectionarray
Bundle selection percentages.
The sum of all percentages must equal 100.
If not specified, the preconfigured allocation ratios are going to be used.
If, for each selection, percentage is not provided, the selection is divided equally (best effort) between bundles. percentage must be provided for all or none of the bundles.
object
Maps a bundle id to an allocation ratio
bundle_idstringrequired
The bundle's unique identifier
percentageoneOf
quantity_truncstring
Selects to which precision to truncate quantities specific to carbon offsetting.
gkgtResponse
currencystringrequired
Currency code
estimated_quantitystringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated quantity (tonnes CO2).
May be lower than requested_quantity.
estimated_offset_coststringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated offset cost
Unit: order quote currency
estimated_total_coststringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated total cost inclusive of Lune fees.
Unit: order quote currency
estimated_commissionstringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Estimated commission
bundlesarrayrequired
Bundles included in the quote including quantity and cost breakdown.
object
bundle_idstringrequired
The bundle's unique identifier
bundle_namestringrequired
The bundle's name
primary_imagestring
A bundle's image URL
quantitystringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Quantity for the specific bundle (tonnes CO2)
unit_pricestringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Bundle unit price per tonne CO2
Unit: order currency
gross_unit_pricestringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Bundle unit price per tonne CO2 inclusive of fees.
Unit: order currency
offset_coststringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
The bundle's net offset cost being purchased.
Unit: order currency
insufficient_available_quantitybooleanrequirednullable
If true, there is no inventory necessary to fully satisfy the order for this bundle.
requested_valuestringrequired
Pattern: ^[0-9]+(\.[0-9]+)?$
Requested order value inclusive of commission
requested_quantitystringrequirednullable
Pattern: ^[0-9]+(\.[0-9]+)?$
Requested quantity of CO2 offsets to purchase in tonnes.
Errors
This API operation can return the following errors:400api_version_invalid400bundle_selection_ratios_invalid400bundle_selection_bundle_invalid400order_value_invalid400bundle_id_invalid400id_invalid400distance_invalid400test_account_name_update_disallowed400bundle_selection_ratios_invalid_format400address_not_found