Skip to main content

​
Logistics Tools

Tools for querying logistics/shipping requests with emission calculations (ISO 14083). Each request has origin, destination, distance, load, vehicle type (TOC), and kgCO2e.

​
list_logistics_requests

Parameters:
ParameterTypeRequiredDescription
organization_idstringNoUUID of the organization
pageintegerNoPage number (default: 1)
sizeintegerNoResults per page (default: 50)
Example queries: 
"Show our recent shipping requests"
"What are the top routes by emissions?"
"How many logistics requests do we have?"
Example response: 
{
  "items": [
    {
      "id": "b652bf60-...",
      "origin": "Madrid, Spain",
      "destination": "Barcelona, Spain",
      "distance_km": 600.0,
      "load": 121.0,
      "load_unit": "kg",
      "toc": "generic_average_road",
      "kgco2e": 11.13,
      "emission_intensity": 153.318,
      "client": "Acme Corp",
      "shipment_date": "2025-11-25",
      "tkm": 72.6,
      "status": "active"
    }
  ],
  "total": 57534,
  "page": 1,
  "size": 50
}

​
Key Fields

  • toc — Type of Carrier (vehicle type used for the shipment)
  • tkm — Tonne-kilometres (load × distance)
  • kgco2e — Kilograms of CO2 equivalent emitted
  • emission_intensity — gCO2e per tonne-kilometre
  • client — Client name for the shipment
  • movement_id — External reference ID