DEV Community

VesselAPI
VesselAPI

Posted on • Originally published at vesselapi.com

How to Measure a Ship's CO Emissions From Land

How to Measure a Ship's CO₂ Emissions From Land

Here's a question that sounds simple until you try to answer it: how much CO₂ did that container ship just emit on its way from Shanghai to Rotterdam?

A practical walkthrough of measuring vessel CO₂ emissions via API — what EEXI actually means, why fuel type changes everything, and how to verify a number before you trust it.

You can see the ship. You know roughly where it went, and roughly how fast. You can look up its size. And yet the honest answer — the one a regulator or a carbon accountant would actually accept — requires you to know things about that vessel that aren't printed on the hull. What fuel was in its tanks. What its engines were designed to do at three-quarters load. Whether its propeller has been polished this year. Whether the paint on its hull is the slick anti-fouling kind or the kind that's currently hosting a small ecosystem of barnacles.

This tutorial is about closing that gap. We're going to walk through how to ask our /emissions endpoint for the CO₂ output of a single vessel, and — more interestingly — how to understand what the API is actually doing under the hood. Because if you're going to make a decision based on a number, you should know where the number came from.

The thing everyone gets wrong

Most people assume ship emissions are calculated the way car emissions are: you burn X litres of fuel, each litre contains Y grams of carbon, multiply, done.

That's roughly right for a car. It falls apart for ships almost immediately.

The IMO does publish carbon factors for each marine fuel type, and they're as clean as you could want. For heavy fuel oil (HFO), the number is 3.114 grams of CO₂ per gram of fuel burned. For VLSFO — the blended low-sulphur product most large vessels burn today — it's 3.151. For marine gas oil (MGO), 3.206. For LNG, the direct combustion factor is 2.750. These aren't interchangeable. Submitting an MRV report with the HFO factor against a tank of VLSFO will fail verification, which is exactly the kind of thing I got wrong the first time I tried to reconcile a vessel's annual fuel mix against its reported emissions. The numbers look close. They aren't.

If you knew exactly how much of each fuel a ship had burned, you'd be done. The problem is that almost nobody outside the ship does. Aggregate fuel consumption is reported annually under the IMO Data Collection System; per-voyage data is collected by the EU MRV regime for vessels calling at European ports, but it isn't publicly accessible. If you want per-voyage emissions from the outside, you have to estimate them — working backwards from what the ship was designed to burn, and adjusting for what it probably actually did.

The starting point for that estimate is a three-letter acronym you'll see everywhere in this domain.

What EEXI actually is

EEXI stands for Energy Efficiency Existing Ship Index. The name sounds like it was designed to deter questions, so let's ignore it.

What EEXI actually is: a fuel economy rating. It's the mpg sticker on the window, except the window is a 300-metre container ship and the sticker is buried in a classification society database in Hamburg.

For most existing vessels of 5,000 gross tonnes and above — broadly, the ships big enough to do international trade and already in service when the regulation took effect on 1 January 2023 — the IMO requires a calculation that answers a single question: if this ship sailed at the speed corresponding to 75% of its maximum continuous engine rating, in calm weather, in a defined reference state, how many grams of CO₂ would it emit per tonne of cargo per nautical mile?

That's it. Standardised conditions, one number, comparable across vessels. A modern, efficient large bulk carrier might come in around 3 g CO₂/tonne-nm. An older, smaller one might be roughly double that. Container ships sit higher again because their capacity is measured differently. Lower is better, the way fewer litres per 100km is better on a car.

EEXI on its own doesn't tell you what a ship emitted yesterday. But combined with a known route, a speed profile, and a load factor, it lets you build a credible estimate without ever needing the captain's fuel logs.

The request

Let's measure something. Here's a minimal call for a vessel by IMO number:

curl "https://api.vesselapi.com/v1/emissions?imo=9395044" \
  -H "Authorization: Bearer YOUR_API_KEY"
Enter fullscreen mode Exit fullscreen mode

And here's the relevant chunk of the response, trimmed for clarity. The values are illustrative — they show the shape of the response, not certified figures for this vessel:

"emissions": {
  "eexi": {
    "attained": 6.82,
    "required": 7.84,
    "unit": "g_co2_per_tonne_nm",
    "compliant": true
  },
  "fuel": {
    "primary": "VLSFO",
    "eca": "MGO",
    "carbon_factor_primary": 3.151,
    "carbon_factor_eca": 3.206
  },
  "verifier": {
    "name": "DNV",
    "verified_at": "2023-04-12",
    "method": "approved_calculation"
  }
}
Enter fullscreen mode Exit fullscreen mode

The most important field here is probably the one you'd skip past on first reading: verifier. We'll come back to it. First, the things this response is telling you about the ship itself.

EEXI arrives as a pair — attained and required. EEXI is an efficiency index, so lower is better, and required is a ceiling: the maximum value the IMO will accept for this ship type and size. The vessel is compliant if attained sits at or below that ceiling. If it doesn't, the primary remedy is an Engine Power Limitation: a technical and administrative measure that caps engine output and brings the attained index down. Switching fuels operationally doesn't change EEXI itself — EEXI is a design-condition index, fixed at certification. Fuel choices affect the operational metric (CII) instead. A ship that can't demonstrate EEXI compliance can't get its certificate endorsed, which means in practice it can't legally trade. It isn't really a menu.

The fuel block reports two carbon factors because most large vessels switch fuels at ECA boundaries — the North Sea, the Baltic, the US and Canadian coasts, and (from 1 May 2025) the Mediterranean. VLSFO on the open ocean, MGO or another compliant blend inside the zone. For a voyage that crosses an ECA boundary, you need to know which fuel was burning where.

Why the verifier matters more than the number

An emissions number without a verifier is a rumour.

I mean this practically. EEXI calculations are prepared by the ship's owner or technical manager and submitted to a classification society — DNV, ABS, Lloyd's Register, ClassNK, Bureau Veritas. These bodies do the actual checking: engine specs, hull form, propulsion train, sea margin assumptions, the lot. They either approve the calculation or send it back. The number that survives this process is the only one that means anything in a regulatory context.

When the API returns a verifier block, it's saying: this isn't our estimate. This is the number a recognised classification society signed off on, with their reputation attached. If the verifier field is missing, or shows "method": "estimated", you're looking at a calculated approximation. Most APIs don't surface this distinction at all, which is how an estimated figure ends up in someone's audited disclosure.

For the EU ETS, which began applying to shipping in 2024 (40% of verified emissions surrendered that year, 70% in 2025, 100% from 2026), or for CSRD disclosures, or for any scope 3 reporting that has to survive contact with an auditor — the verified number is the one that matters.

From EEXI to an actual voyage

EEXI gives you grams of CO₂ per tonne-nautical-mile under reference conditions. To get the emissions of an actual voyage, the back-of-envelope multiplication is:

voyage_emissions = EEXI × cargo_tonnes × distance_nm × correction_factor
Enter fullscreen mode Exit fullscreen mode

This formula works, with friction. EEXI is calibrated to a defined reference state, which for bulk carriers and tankers is 70% of deadweight but for container ships is a TEU-based capacity figure — not a deadweight fraction at all. Check the IMO guidelines for the vessel class before applying a load correction. The cargo_tonnes you plug in should reflect actual cargo on board, because a container ship sailing 60% laden carries 60% of the cargo but burns considerably more than 60% of the fuel. And the formula degenerates on a ballast leg: zero cargo gives zero emissions, which is physically impossible. Ballast voyages need a displacement-based substitution or allocation back to the laden leg.

The correction factor is where the rest of the honesty lives. Real voyages aren't reference conditions. Heavy weather adds fuel. Slow steaming subtracts it — dramatically. For full-form displacement vessels, fuel consumption scales with speed at an exponent typically between 2.7 and 3.5, with the cube as the standard admiralty anchor. That non-linearity is why dropping container ship service speeds from around 21 knots toward 14 was, by most accounts, the single biggest operational lever the industry pulled in the last decade. Not technology. Just patience, and the willingness to leave port a day earlier.

For a rough estimate, a correction factor between 1.1 and 1.3 covers most container and bulk voyages in fair-to-moderate conditions. For anything precise, you want AIS-derived speed profiles for the actual voyage — which is the bridge between the /emissions endpoint and the /positions endpoint. Combine the two and the error band tightens, though the residual error depends heavily on voyage type and the quality of the load assumption.

What this still doesn't tell you

EEXI is a design-condition metric. It doesn't capture hull fouling — industry studies suggest six months of moderate fouling can add roughly 10% to fuel burn, and severely fouled hulls have been measured at 30% or worse. It doesn't capture weather routing decisions. It doesn't capture auxiliary engines running in port, which on a large container ship is not a rounding error. And it doesn't capture methane slip from LNG carriers, which deserves a paragraph of its own.

Methane slip is uncombusted natural gas escaping through the engine. It's a separate problem from the LNG carbon factor, and it doesn't show up in EEXI at all. Fossil methane carries a GWP₁₀₀ of roughly 30 per the most recent IPCC figures (the exact value depends on the assessment report and whether you include climate-carbon feedbacks), so a few percent of slip can erase the apparent climate advantage of switching from oil to gas. Two-stroke high-pressure LNG engines slip very little; some four-stroke low-pressure designs slip enough to matter. The API returns a CO₂-only figure and flags LNG vessels separately, because rolling slip into a single number requires picking a GWP horizon, and that choice is a political one as much as a scientific one.

So: where does that leave you? If you're filing EU ETS reports, the verified EEXI number is where you start and your auditor decides whether you need to go further. If you're building a product that surfaces emissions to end users, a well-bounded estimate is almost certainly fine and most users won't know the difference. If you're trying to prove in a contract dispute that a specific voyage exceeded a specific threshold — call a naval architect, not an API.

At sea, with no fuel pump to read and no tailpipe to sniff, the gap between what was burned and what we can prove was burned is wider — and stranger — than most people realise.

Top comments (0)