Skip to content
HALOWERK

Ortwerk

fleet ev fit

For each vehicle and day: energy need = km × consumption × (1 + winter uplift); usable energy = usable battery × (1 − degradation) × (1 − reserve). A day is covered if need ≤ usable energy. Returns coverage share, range per charge, the 95th-percentile day (nearest rank) and the usable battery it would need, extra energy on uncovered days, and — with depot dwell time and charging power — whether the recharge (need / charging efficiency / power) fits overnight. The verdict compares coverage.

POST https://ort.halowerk.com/v1/fleet-ev-fit

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
vehiclesarrayYes
evobjectYesCandidate electric vehicle.
reserve_pctnumberNoEnergy kept in reserve (not planned for driving).
winter_uplift_pctnumberNoExtra consumption in cold weather to plan for.
battery_degradation_pctnumberNoCapacity loss to plan for (ageing).
charging_efficiency_pctnumberNoGrid-to-battery efficiency.
required_day_coverage_pctnumberNoShare of days that must be covered without en-route charging for the verdict "fit".
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "vehicles",
    "ev"
  ],
  "properties": {
    "vehicles": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "daily_km"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Vehicle reference."
          },
          "daily_km": {
            "type": "array",
            "minItems": 1,
            "maxItems": 400,
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 3000
            },
            "description": "Kilometres per operating day (from GPS or logbook)."
          },
          "depot_dwell_hours": {
            "type": "number",
            "minimum": 0,
            "maximum": 24,
            "description": "Typical daily time at the depot available for charging."
          }
        }
      }
    },
    "ev": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "usable_battery_kwh",
        "consumption_kwh_per_100km"
      ],
      "description": "Candidate electric vehicle.",
      "properties": {
        "usable_battery_kwh": {
          "type": "number",
          "minimum": 5,
          "maximum": 2000,
          "description": "Usable (net) battery capacity."
        },
        "consumption_kwh_per_100km": {
          "type": "number",
          "minimum": 5,
          "maximum": 400,
          "description": "Energy consumption for your duty cycle (from the manufacturer or measurements)."
        },
        "charging_power_kw": {
          "type": "number",
          "minimum": 1,
          "maximum": 1500,
          "description": "Depot charging power per vehicle."
        }
      }
    },
    "reserve_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 50,
      "default": 20,
      "description": "Energy kept in reserve (not planned for driving)."
    },
    "winter_uplift_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "default": 0,
      "description": "Extra consumption in cold weather to plan for."
    },
    "battery_degradation_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 40,
      "default": 0,
      "description": "Capacity loss to plan for (ageing)."
    },
    "charging_efficiency_pct": {
      "type": "number",
      "minimum": 50,
      "maximum": 100,
      "default": 90,
      "description": "Grid-to-battery efficiency."
    },
    "required_day_coverage_pct": {
      "type": "number",
      "minimum": 50,
      "maximum": 100,
      "default": 95,
      "description": "Share of days that must be covered without en-route charging for the verdict \"fit\"."
    }
  }
}

Open original schema

Published input example

{
  "ev": {
    "usable_battery_kwh": 100,
    "consumption_kwh_per_100km": 25,
    "charging_power_kw": 22
  },
  "vehicles": [
    {
      "id": "BOR-AB 123",
      "daily_km": [
        200,
        250,
        310
      ],
      "depot_dwell_hours": 12
    }
  ]
}

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 →