Skip to main content

Calculate an order quote by mass

This endpoint does not create an order. It processes the order as if it were placed, returning estimated cost and bundles allocations.
Parameters
massobject

Mass of CO2 offsets to purchase


bundle_selectionarray of object

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.


quantity_truncenum

Unit, t for tonne, kg for kilogram, g for gram

Enum:
  • g
  • kg
  • t

bundle_massesarray of objectrequired

quantity_truncenum

Unit, t for tonne, kg for kilogram, g for gram

Enum:
  • g
  • kg
  • t
Returns
currencystringrequired

Currency code


estimated_quantitystring^[0-9]+(\.[0-9]+)?$required

Estimated quantity (tonnes CO2).

May be lower than requested_quantity.


estimated_offset_coststring^[0-9]+(\.[0-9]+)?$required

Estimated offset cost

Unit: order quote currency


estimated_total_coststring^[0-9]+(\.[0-9]+)?$required

Estimated total cost inclusive of Lune fees.

Unit: order quote currency


estimated_commissionstring^[0-9]+(\.[0-9]+)?$required

Estimated commission


bundlesarray of objectrequired

Bundles included in the quote including quantity and cost breakdown.


requested_quantitystring^[0-9]+(\.[0-9]+)?$required

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_valuestring^[0-9]+(\.[0-9]+)?$required

Requested value of CO2 offsets to purchase in the account's currency.

  • POST /orders/by-mass/quote
  • curl 'https://api.lune.co/v1/orders/by-mass/quote' \
      -H 'Authorization: Bearer <API_KEY>' \
      -H 'Content-Type: application/json' \
      -X POST \
      -d '{
        "mass": {
          "amount": "40.501",
          "unit": "t"
        }
      }'
      
  • Response
  • {
      "currency": "GBP",
      "estimated_quantity": "1040",
      "estimated_offset_cost": "7176.00",
      "estimated_total_cost": "7696.00",
      "estimated_commission": "520.00",
      "bundles": [
        {
          "bundle_id": "va1BEV2VZqnzPkYxJgALg0GeQDoXlWO5",
          "bundle_name": "Latin America Forestry",
          "primary_image": "https://assets.lune.co/bundles/latin-america-forestry.png",
          "quantity": "1040",
          "unit_price": "6.90",
          "gross_unit_price": "7.90",
          "offset_cost": "7176.00",
          "insufficient_available_quantity": true
        }
      ],
      "requested_quantity": "1045",
      "requested_value": "7700"
    }