Example Request & Response

Example Request: Pre-Voyage

{
  "id": 1234567890,
  "imo_number": 9839272,
  "departure_port_code": "BEANR",
  "arrival_port_code": "GBFXT",
  "cargo_weight_mt": 1,
  "cargo_reefer": true,
  "match_type": "port"
}

This shipment involved transporting 1 metric tonne of refrigerated cargo on the vessel with IMO number 9839272 from the port of Antwerp (BEANR) to the port of Felixstowe (GBFXT).

Example Response: Pre-Voyage (Simplified)

{
  "id": "1234567890",
  "data_origin": "calculated",
  "quality_flag": "pre_voyage",
  "imo_number": 9839272,
  "name": "MSC ISABELLA",
  "ship_type": "Container",
  "distance_nm": 148.011,
  "co2_well_to_tank_kg": 0.23751138059720292,
  "co2_tank_to_wake_kg": 1.7156354423096496,
  "co2_well_to_wake_kg": 1.9531468229068525,
  "nox_tank_to_wake_kg": 0.04338105724523464,
  "sox_tank_to_wake_kg": 0.0008401582458948891,
  "nmhc_tank_to_wake_kg": 0.0018786720806549637,
  "pm_tank_to_wake_kg": 0.0005565919642881419,
  "co2_equivalent_well_to_tank_kg": 0.30122789919165094,
  "co2_equivalent_tank_to_wake_kg": 1.7469690502910282,
  "co2_equivalent_well_to_wake_kg": 2.048196949482679,
  "total_energy_mj": 22.313177717900068,
  "matched_voyage": null,
  "port_stops": [],
  "operational_factors": null,
  "net_cargo_calculations": null
}

This pre-voyage estimate calculated emissions for transporting cargo on the container ship MSC ISABELLA (IMO 9839272) over a 148-nautical mile route, projecting 1,953.14 kg of CO₂ (Well-to-Wake) and 2,048.19 kg CO₂e emissions, based on historical vessel data and routing assumptions. Pre-Voyage calculations do not refer to an actual shipment and therefore don't return operational factors, port stops, net cargo calculations, etc.

Example Request: Post-Voyage

{
  "id": 12345678,
  "imo_number": 9839272,
  "departure_port_code": "BEANR",
  "arrival_port_code": "GBFXT",
  "departure_datetime": "2025-04-03 12:00:00Z",
  "arrival_datetime": "2025-04-10 12:00:00Z",
  "cargo_weight_mt": 1,
  "cargo_reefer": true,
  "match_type": "port"
}

This shipment transported 1 metric tonne of refrigerated cargo on the vessel with IMO number 9839272 from Antwerp (BEANR) to Felixstowe (GBFXT), departing on April 03 and arriving on April 10, 2025, with port-matching based on port-level criteria.

Example Response: Post-Voyage (Simplified)

{
  "id": "12345678",
  "data_origin": "calculated",
  "quality_flag": "past_voyage",
  "imo_number": 9839272,
  "name": "MSC ISABELLA",
  "ship_type": "Container",
  "distance_nm": 233.49025586501847,
  "co2_well_to_tank_kg": 1.2709789949417554,
  "co2_tank_to_wake_kg": 7.358582259131788,
  "co2_well_to_wake_kg": 8.629561254073543,
  "nox_tank_to_wake_kg": 0.12026294912948511,
  "sox_tank_to_wake_kg": 0.00037869055803198265,
  "nmhc_tank_to_wake_kg": 0.004715257585657383,
  "pm_tank_to_wake_kg": 0.001907575113102199,
  "co2_equivalent_well_to_tank_kg": 1.3914539959466954,
  "co2_equivalent_tank_to_wake_kg": 7.506955155830727,
  "co2_equivalent_well_to_wake_kg": 8.898409151777422,
  "total_energy_mj": 97.62519384168466,
  "matched_voyage": {
    "departure": {
      "match_result": "found"
    },
    "arrival": {
      "match_result": "found"
    }
  },
  "port_stops": [
    "NLRTM",
    "GBFXT"
  ],
  "operational_factors": {
    "average_speed_knots": 13.2,
    "average_utilization_percent": 67.4,
    "average_utilization_percent_source": "modelled",
    "percent_time_sailing": 84.1
  },
  "net_cargo_calculations": {
    "net_intensity_co2_equivalent_well_to_wake": 5.301414325031183,
    "net_transport_work_mt_km": 45398979.17938079,
    "net_co2_equivalent_emissions_kg": 1.6918853731576493,
    "is_in_accordance_with_iso_14083": true
  }
}

This post-voyage emission report covers the container ship MSC ISABELLA (IMO 9839272), which transported 1 tonne of refrigerated cargo from Antwerp (BEANR) to Felixstowe (GBFXT) in the given time window, over 233.49 nautical miles, stopping at NLRTM and emitted an estimated 8,629.56 kg of CO₂ (Well-to-Wake) and 8,898.41 kg CO₂e, with voyage matching confirmed. The average speed was 13.2 knots, the average ship's utilization was 67,4% (source: cargoFP utilization model), and the percentage time sailing was 84.1%.