Lune Docs Logo

Multi-leg shipments
Sea shipments
Vessel tracking
Road shipments
Air shipments

Transactions

Dashboard

Logistics analytics

Spend management analytics

Carbon credits

Accounts

Emission calculations

Logistics methodology

Carbon credit orders

Authentication
Pagination

General
Single leg

By transaction details
By document

Company
Electricity
Flight
Passenger transportation
Raw emission factor

Emission factors

Analytics
Sustainability pages

Quotes
Orders
Carbon certificates

Projects
Project bundles
Bundle selections
Bundle portfolios
Payments

Accounts
Client accounts

Webhook

Sea shipments

Calculate the CO₂e emissions for a shipment by sea using one of two methods:
  1. Container ships: A basic method that requires the least amount of details about the shipment.
  2. Non-container vessels: A single input method which requires fuel and DWT.

Pre-requisites

Complete the following setup steps before using this guide:
/illustrations/stamp-key.png
Generate an API key and authenticate your account.
/illustrations/stamp-accounts.png
Set up Client Accounts to track emissions for your individual customers.
/illustrations/stamp-route.png
Review how to calculate emissions for multi-leg shipments using the API.

1. Gather shipment details

  • When setting the route for sea transport, the source and destination should be locations of existing ports, preferably in UN/LOCODE format. If the port locations can’t be identified, consider using the distance property for route instead.
    • Container ship estimate
    To create a container ship estimate, specify container_ship as the value for vessel_type in the method object, as shown below:
  • Vessel type input
    • If the container is refrigerated, include the optional refrigerated boolean. For greater precision, add the trade route using the trade_lane property. If the trade lane is not specified, Lune will automatically infer the trade lane from the route object.For example, if shipping from Port of Santos, Brazil to Port of Sines, Portugal, include the trade_lane property, with the value disaggregated_europe_to_south_america.Trade lane values are bidirectional. In the example above, disaggregated_europe_to_south_america covers trade routes between Europe and South America, in both directions. For the complete list of trade lane values, go to the API Reference.With all optional properties included, the request for a container ship with two refrigerated TEUs travelling from Port of Santos, Brazil to Port of Sines, Portugal would appear as:
  • CURL request for sea shipment
    • While the shipment object can accept mass or containers as inputs, using containers is preferred for emission calculations involving container ships.
    Non-container ship estimate
    To calculate a non-container vessel estimate, select the appropriate value for the method property.There are over 100 possible options. Each value represents a combination of three key parameters: ship type, deadweight tonnage, and fuel type.The values follow a consistent naming pattern to convey detailed information:
    • Vessel type: The category of the ship (for example, bulk carrier, chemical tanker, RORO).
    • Deadweight tonnage: Indicates the ship’s cargo-carrying capacity.
      • Upper bounds are indicated by suffixes like xdwkt (for example, 10dwkt for 10 kilotonnes or under).
      • Lower bounds use prefixes like over_xdwkt (for example, over_40dwkt for over 40 kilotonnes).
    • Fuel type: Specifies the fuel used.
      • hfo: Heavy Fuel Oil
      • vlsfo: Very Low Sulphur Fuel Oil
      • mdo: Marine Diesel Oil
    All input values start with sea and use underscores (_) to separate the components. For example:
    sea_bulk_carrier_10dwkt_hfo
    Bulk carrier with a capacity of up to 10 kilotonnes DWT, using heavy fuel oil.
    sea_chemical_tanker_over_40dwkt_vlsfo
    Chemical tanker with a capacity of more than 40 kilotonnes DWT, using very low sulphur fuel oil.
    sea_roro_15dwkt_mdo
    Roll-on/roll-off vessel with a capacity of up to 15 kilotonnes DWT, using marine diesel oil.
    Look through the entire list of options to determine which value best represents your shipment.For the full list of supported values, go to the API Reference.

    2. Make the API request

    To calculate emissions for sea shipments, use the estimates/shipping/multi-leg/ endpoint. Send a POST request to this endpoint to create an emissions estimate.
  • Remember to add the Authorization header with your generated Bearer Token, as well as a Lune Account header with the client account that this emission is being calculated for.
    • Sample request
    The sample request below generates an estimate for a 10.6 tonnes shipment from the Port of Santos to the Port of Sines, traveling on a RORO vessel.
  • CURL request for sea shipment
    • To interpret the results, go to the Multi-leg shipment guide. If your shipment has multiple legs involving different transport methods, refer to the relevant guides for constructing your multi-leg object.Success! You’ve successfully calculated emissions for the sea transport legs of your shipment. Another step toward a greener future!

    What to do next...

    Now that you’ve calculated an emission estimate using the methods above, here are some next steps to explore!
    /illustrations/stamp-satellite.png
    Calculate emissions for sea shipments using vessel tracking.
    /illustrations/stamp-carbon.png
    Offset the calculated emissions by purchasing carbon credits through the API.
    /illustrations/stamp-analytics.png
    Generate an analytics report for your customers about their emissions.

    Troubleshooting

    If encountering any issues with the non-container vessel estimate, please double check your input to ensure it matches one of the expected values in the API reference.For further assistance, contact our support team.