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-fitInputs
| Field | Type | Required | Description |
|---|---|---|---|
| vehicles | array | Yes | |
| ev | object | Yes | Candidate electric vehicle. |
| reserve_pct | number | No | Energy kept in reserve (not planned for driving). |
| winter_uplift_pct | number | No | Extra consumption in cold weather to plan for. |
| battery_degradation_pct | number | No | Capacity loss to plan for (ageing). |
| charging_efficiency_pct | number | No | Grid-to-battery efficiency. |
| required_day_coverage_pct | number | No | Share 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\"."
}
}
}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
- Ortwerk0.01 USDC
area coverage
POSThttps://ort.halowerk.com/v1/area-coverageRuns one multi-source Dijkstra from all origins (Routing runs on HALOWERK's own graph of the German road and path network built from OpenStreetMap (Geofabrik germany-latest.osm.pbf, data until 2026-11-12, ODbL 1.0; 25 million nodes, edges a
- Ortwerk0.004 USDC
autobahn roadworks
POSThttps://ort.halowerk.com/v1/autobahn-roadworksFetches live roadworks (long- and short-term) and closures per motorway from the public Autobahn App API of Die Autobahn GmbH des Bundes (no key; https://verkehr.autobahn.de/o/autobahn). The free-text periods are parsed into concrete interv
- Ortwerk0.004 USDC
avalanche bulletin
POSThttps://ort.halowerk.com/v1/avalanche-bulletinFresh official WSL SLF CAAMLv6 JSON for one Swiss warning region, in de/en/fr/it with explicit actual-language fallback. Includes the complete unmodified bulletin, all elevation/aspect/time distinctions, publication and validity times, sour