API Reference

Fuel types

For greater accuracy in CO₂e calculations, you can specify the fuel type from the following options.

🚚 For road mode

Fuel TypeDescription
DIESELStandard diesel fuel
CNGCompressed Natural Gas
LNGLiquefied Natural Gas
HVOHydrotreated Vegetable Oil
ELECElectric power; calculations use local emission factors based on the origin
BIOLNGBio-based Liquefied Natural Gas
BIOCNGBio-based Compressed Natural Gas
BIODIESELBio-based diesel fuel
HYDROGEN_GASEOUS_FCVHydrogen fuel for Fuel Cell Vehicles
LPGLiquefied Petroleum Gas (for vans <3.5t in specific regions)
PETROLStandard petrol fuel (for vans <3.5t in specific regions)

Diesel-Biodiesel Blends:

BlendComposition
B199% Diesel, 1% Biodiesel
B298% Diesel, 2% Biodiesel
B595% Diesel, 5% Biodiesel
B793% Diesel, 7% Biodiesel
B1090% Diesel, 10% Biodiesel
B2080% Diesel, 20% Biodiesel
B3070% Diesel, 30% Biodiesel
B5050% Diesel, 50% Biodiesel

🚢 For sea mode

Fuel TypeDescription
HFOHeavy Fuel Oil, commonly used in large cargo ships.
VLSFOVery Low Sulfur Fuel Oil, compliant with IMO 2020 sulfur regulations.
ULSFOUltra Low Sulfur Fuel Oil, with even lower sulfur content than VLSFO.
MDOMarine Diesel Oil, a lighter and more refined fuel than HFO.
MGOMarine Gas Oil, similar to MDO but with even lower sulfur content.
LNGLiquefied Natural Gas, a lower-emission alternative fuel.
BIOLNGBio-based Liquefied Natural Gas, derived from renewable sources.
LSMGOLow Sulfur Marine Gas Oil, a cleaner alternative to standard MGO.
METHANOLMethanol, a clean-burning fuel with reduced emissions.
BIOMETHANOLBio-based methanol, produced from renewable feedstocks.
IFO380Intermediate Fuel Oil (IFO) with a viscosity rating of 380 centistokes.
LNG_CMACGM_VASLNG fuel variant used in CMA CGM's Value Added Services (VAS) for eco-friendly shipping.
UCOUsed Cooking Oil, a renewable fuel option derived from waste oils and used in Shipping Lines' Value Added Services (VAS) catalog.
METHANOL_COALMethanol derived from coal-based processes.
METHANOL_GASMethanol derived from gas-based processes.
METHANOL_RENEWABLESMethanol produced entirely from renewable energy sources.

Endpoints

The fuel parameter is applicable in the following APIs:

  • Shipment API: /shipment/v2/report/co2
  • Run API: /asset/v2/run/co2 (accepted values are only DIESEL, PETROL and LPG).

Notes:

  • If no fuel is specified: the API defaults to the vessel’s least green fuel option, ensuring compliance with GLEC’s conservative approach for emissions assumptions.
  • For sea mode:
    • Fuel input requires a vessel specification (name or imo) for accurate emissions modeling.
    • Dual-fuel vessels: user input prevails if the vessel can operate on the specified fuel (e.g., ULSFO instead of HFO, or LNG instead of HFO for LNG-compatible ships).
    • Compatibility rules: the vessel’s fuel configuration takes precedence when the input fuel is incompatible (e.g., LNG or Methanol cannot be used on a vessel designed for HFO only). Fuel compatibility is verified using our vessel database, which includes detailed vessels configurations.
    • HFO, VLSFO, and ULSFO comply with IMO sulfur regulations and are commonly used in traditional maritime shipping.
  • For road mode:
    • ELEC calculations use local emission factors based on the origin region.
    • LPG and PETROL are available for vans weighing less than 3.5t in Europe, South America, Africa, and Asia.