📄 Shipment API v2.1 Certificate release
4 days ago by Marine GONZALEZ
📅 October 2025
While most of the team’s efforts this cycle were focused on app developments — preparing its upcoming redesign and our latest EU ETS feature (still under wraps) — one important feature has been released publicly on the API side: the integration of certificates in Shipment API v2.1.
📚 Overview
🌱 Carbon Emissions APIs
✨ New features in /shipment/v2/report/co2
/shipment/v2/report/co2🆕 Shipment API v2.1 – Certificate generation
The generateCertificate=true parameter is now available again in v2.1 requests.
It produces a GHG Certificate PDF summarizing emissions per shipment, aligned with the new v2.1 contract.
Main updates:
- The certificate now uses the new
transportChainElementsstructure, displaying both legs and hubs. - The footer message has been updated to reflect ISO 14083:2023 compliance.
- Field mapping aligned with the v2.1 payload structure (
id,referenceNumber,status,carrier.nameorcarrier.scac).
Notes
- Reuses the trusted v2.0 layout – no redesign or new data fields.
- Remains shipment-level only (not intended for aggregated reporting).
Exemple
{
"metadata": {
"id": "FLE356727T",
"referenceNumber": "224010",
"status": "COMPLETED"
},
"orders": [
{
"type": "FCL",
"nContainers": 6
}
],
"transportChainElements": [
{
"type": "leg",
"from": "CNTOL",
"to": "CNSHA",
"mode": "road"
},
{
"type": "leg",
"from": "CNSHA",
"to": "USLAX",
"mode": "sea"
},
{
"type": "leg",
"from": "USLAX",
"to": "USCHI",
"mode": "rail"
}
]
}{
"metadata": {
"id": "FLE356727T",
"referenceNumber": "224010",
"status": "COMPLETED"
},
"parameters": {
"orders": [
{
"type": "FCL",
"nContainers": 6.0
}
]
},
"co2e": {
"total": 12006966,
"wtt": 2234858,
"ttw": 9772108,
"intensity": 0.01364
},
"transportChainElements": [
{
"type": "leg",
"from": {
"locode": "CNTOL",
"iata": null,
"coordinates": [
117.753305378858,
30.9110671056251
],
"city": "Tongling Pt",
"country": "China",
"region": "North East Asia"
},
"to": {
"locode": "CNSHA",
"iata": null,
"coordinates": [
122.06550521343334,
30.61798396262171
],
"city": "Shanghai",
"country": "China",
"region": "North East Asia"
},
"tradeLane": "Intra NE Asia",
"mode": "road",
"parameters": {},
"properties": {
"dataType": "default",
"distance": {
"sfd": {
"total": 474913
},
"used": {
"total": 474913,
"source": "daf"
}
},
"model": {
"name": "sfd-direct-emissionfactors"
},
"region": "Asia",
"truck": {
"minSize": 26.0,
"maxSize": 32.0,
"loadFactor": 0.72,
"emptyRunning": 0.3,
"fuelType": "diesel",
"combinedEmptyRunningLoadFactor": null
},
"orders": [
{
"weight": 60000.0,
"type": "fcl",
"containerSizeTypeCode": "20gp",
"co2e": {
"total": 4310689,
"wtt": 1008145,
"ttw": 3302544,
"intensity": 0.15128
},
"nContainers": 6.0,
"nTeu": 6.0
}
],
"carrier": null
},
"co2e": {
"total": 4310689,
"wtt": 1008145,
"ttw": 3302544,
"intensity": 0.15128
}
},
{
"type": "hub",
"location": {
"locode": "CNSHA",
"iata": null,
"coordinates": [
122.06550521343334,
30.61798396262171
],
"city": "Shanghai",
"country": "China",
"region": "North East Asia"
},
"parameters": {},
"properties": {
"dataType": "default",
"source": "auto_generated",
"hubType": "maritime_container_terminal",
"orders": [
{
"weight": 60000.0,
"type": "fcl",
"containerSizeTypeCode": "20gp",
"co2e": {
"total": 64200,
"wtt": 12840,
"ttw": 51360
},
"nContainers": 6.0,
"nTeu": 6.0
}
]
},
"co2e": {
"total": 64200,
"wtt": 12840,
"ttw": 51360
}
},
{
"type": "leg",
"from": {
"locode": "CNSHA",
"iata": null,
"coordinates": [
122.06550521343334,
30.61798396262171
],
"city": "Shanghai",
"country": "China",
"region": "North East Asia"
},
"to": {
"locode": "USLAX",
"iata": null,
"coordinates": [
-118.2633947973481,
33.729084264315986
],
"city": "Los Angeles",
"country": "United States",
"region": "North America - West Coast"
},
"tradeLane": "Asia to-from North America WC",
"mode": "sea",
"parameters": {},
"properties": {
"dataType": "default",
"distance": {
"sfd": {
"total": 10638735
},
"used": {
"total": 12234545,
"source": "daf",
"seca": 1081572
}
},
"model": {
"name": "sfd-direct-emissionfactors"
},
"vessel": {
"imo": null,
"name": "Asia to-from North America WC GLEC Representative Vessel",
"minTeu": null,
"maxTeu": null,
"minDwt": null,
"maxDwt": null,
"fuelType": null
},
"tradeLane": "Asia to-from North America WC",
"orders": [
{
"weight": 60000.0,
"type": "fcl",
"containerSizeTypeCode": "20gp",
"co2e": {
"total": 4136340,
"wtt": 625558,
"ttw": 3510783,
"intensity": 0.00648
},
"nContainers": 6.0,
"nTeu": 6.0
}
]
},
"co2e": {
"total": 4136340,
"wtt": 625558,
"ttw": 3510783,
"intensity": 0.00648
}
},
{
"type": "hub",
"location": {
"locode": "USLAX",
"iata": null,
"coordinates": [
-118.2633947973481,
33.729084264315986
],
"city": "Los Angeles",
"country": "United States",
"region": "North America - West Coast"
},
"parameters": {},
"properties": {
"dataType": "default",
"source": "auto_generated",
"hubType": "maritime_container_terminal",
"orders": [
{
"weight": 60000.0,
"type": "fcl",
"containerSizeTypeCode": "20gp",
"co2e": {
"total": 64200,
"wtt": 12840,
"ttw": 51360
},
"nContainers": 6.0,
"nTeu": 6.0
}
]
},
"co2e": {
"total": 64200,
"wtt": 12840,
"ttw": 51360
}
},
{
"type": "leg",
"from": {
"locode": "USLAX",
"iata": null,
"coordinates": [
-118.2633947973481,
33.729084264315986
],
"city": "Los Angeles",
"country": "United States",
"region": "North America - West Coast"
},
"to": {
"locode": "USCHI",
"iata": "CHI",
"coordinates": [
-87.6101792055955,
41.7542807805185
],
"city": "Chicago Airports",
"country": "United States",
"region": "North America - East Coast"
},
"tradeLane": "Intra North America",
"mode": "rail",
"parameters": {},
"properties": {
"dataType": "default",
"distance": {
"sfd": {
"total": 3552315
},
"used": {
"total": 3552315,
"source": "daf"
}
},
"model": {
"name": "sfd-direct-emissionfactors"
},
"orders": [
{
"weight": 60000.0,
"type": "fcl",
"containerSizeTypeCode": "20gp",
"co2e": {
"total": 3431536,
"wtt": 575475,
"ttw": 2856061,
"intensity": 0.0161
},
"nContainers": 6.0,
"nTeu": 6.0
}
]
},
"co2e": {
"total": 3431536,
"wtt": 575475,
"ttw": 2856061,
"intensity": 0.0161
}
}
],
"certificateUrl": "https://app.searoutes.com/api/certificate/da04271f-c0cb-4552-95ce-d1d085ad67b9/certificate.pdf"
}
You made it to the end of our changelog, thanks for reading 👏🏼We'd love to hear your thoughts on these updates. Send us your feedback at [email protected]!