Sea Freight: EMSA 🇪🇺
Calculate sea freight emissions with the methodology of the European Maritime Safety Agency (EMSA), which is based on ships' operational data: fuel consumption records, monitoring system data and voyage specifics.
Sample requests
Send the first body for a quote before booking. Once the booking is final, send it again with audit set to true.
{
"expand": ["items"],
"items": [{
"audit": false,
"type": "sea_freight",
"external_reference": "test_1",
"origin": "USNYC",
"destination": "DEBER",
"weight_in_tonnes": 24,
"vessel_model": "lita",
"vessel_type": "bulk_carrier",
"verifier_name": "verifavia_sarl",
"methodology": "EU-EMSA"
}]
}audit_for is optional
Pass the ID of an auditable entity when you calculate on behalf of that entity. Otherwise, leave it out.
Defaults
vessel_type has no default. If you send neither vessel_type nor vessel_model, SQUAKE uses a default emission factor instead of a specific vessel's.
Request fields
typestringrequiredsea_freight
methodologystringrequiredEU-EMSA
originstringSQUAKE tries to resolve any format. Ideally, use the Post standard for addresses, UN/LOCODE for ports (DEHAM), or latitude and longitude (+40.712,-74.006).
destinationstringSame formats as origin.
distance_in_kmnumberTakes priority over origin and destination. Without it, SQUAKE resolves the distance from them.
weight_in_tonnesnumberCargo weight in tonnes.
vessel_modelstringSee the database for values.
verifier_namestringSee the database for values.
verifier_accreditation_numberstringSee the database for values.
external_referencestringYour identifier for the item, up to 128 characters, so you can match results to requests. SQUAKE doesn't guarantee the order of items.
auditbooleanSet to true to create immutable audit records for finalised calculations. Must be enabled for your account.
POST /v2/calculations in the API referenceSample response
{
"carbon_quantity": 2119391,
"carbon_unit": "gram",
"items": [{
"carbon_quantity": 2119391,
"carbon_unit": "gram",
"external_reference": "test_1",
"type": "sea_freight",
"methodology": "EU-EMSA",
"distance": 7356.0,
"distance_unit": "kilometer"
}]
}Bibliography
CO2 Emission Report. EMSA. mrv.emsa.europa.eu