Skip to content
HALOWERK

Ortwerk

fuel cost trip

Multiplies the kilometres of each leg by the consumption (litres per 100 km) and the national average consumer price incl. duties and taxes of the requested fuel (Euro-super 95, diesel or LPG) from the latest European Commission Weekly Oil Bulletin (prices with taxes, EUR per 1,000 l, weekly, all 27 EU member states; https://energy.ec.europa.eu/data-and-analysis/weekly-oil-bulletin_en; reuse under CC BY 4.0). Prices can be overridden per country, which also allows non-EU legs. Returns litres.

POST https://ort.halowerk.com/v1/fuel-cost-trip

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
legsarrayYes
fuelstringNo
consumption_l_per_100kmnumberYes
prices_eur_per_lobjectNoOptional own prices per country code, overriding the Bulletin.
tank_lnumberNoTank size for the refuelling comparison.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "legs",
    "consumption_l_per_100km"
  ],
  "properties": {
    "legs": {
      "type": "array",
      "minItems": 1,
      "maxItems": 30,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "country",
          "km"
        ],
        "properties": {
          "country": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "ISO 3166-1 alpha-2 code (Greece: GR)."
          },
          "km": {
            "type": "number",
            "minimum": 0,
            "maximum": 20000
          }
        }
      }
    },
    "fuel": {
      "type": "string",
      "enum": [
        "euro95",
        "diesel",
        "lpg"
      ],
      "default": "diesel"
    },
    "consumption_l_per_100km": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 150
    },
    "prices_eur_per_l": {
      "type": "object",
      "additionalProperties": {
        "type": "number",
        "exclusiveMinimum": 0,
        "maximum": 20
      },
      "description": "Optional own prices per country code, overriding the Bulletin."
    },
    "tank_l": {
      "type": "number",
      "minimum": 1,
      "maximum": 2000,
      "description": "Tank size for the refuelling comparison."
    }
  }
}

Open original schema

Published input example

{
  "legs": [
    {
      "country": "DE",
      "km": 420
    },
    {
      "country": "AT",
      "km": 180
    }
  ],
  "fuel": "diesel",
  "consumption_l_per_100km": 28,
  "tank_l": 600
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’