# Karte Halowerk Restricted Route Checker

> Karte Halowerk Restricted Route Checker is a paid API for AI agents from karte.halowerk.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-15).

Checks a corridor around a route (two-point line) or single point in OpenStreetMap for physical and legal restrictions, and evaluates each against a described vehicle to determine whether it is blocked.

## Facts

- Endpoint: POST https://karte.halowerk.com/v1/restricted-route
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/karte-halowerk-restricted-route-checker-846fca31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q2cz95ZsgRkJEfdygLbS0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability karte-halowerk-restricted-route-checker-846fca31 -d '<json body>'
```

Example prompt: Can you check the route between 52.5200° N, 13.4050° E and 52.5100° N, 13.3900° E for any road restrictions that would block a truck that is 4 metres tall, 2.5 metres wide, and weighs 12 tonnes?

## When to prefer this

Use this endpoint when you need to check whether a specific vehicle type can legally and physically travel between two points or near a single location, based on OpenStreetMap-recorded restrictions. Prefer it over generic routing APIs when you need granular per-restriction details and vehicle-specific blocking decisions rather than just a navigable path.

## Known failure modes

- Missing or invalid coordinates returns a validation error
- No OSM data available for the corridor may return an empty restriction list
- Vehicle parameters out of expected range may cause a processing error
- Corridor too long or too wide may exceed service limits
- Malformed vehicle description may result in restrictions being evaluated incorrectly

## How this service works

Collects the physical and legal restrictions recorded in OpenStreetMap within a corridor around the straight line between two points, or around a single point, and decides for each one whether it stops the vehicle described in the request. The work is in reading the values.

## Output

A list of physical and legal restrictions (barriers, access tags, weight/height/width limits, etc.) found in OpenStreetMap within the corridor, each annotated with whether it blocks the described vehicle, plus the restriction type and its recorded value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "object",
   "required": [
    "lat",
    "lon"
   ],
   "properties": {
    "lat": {
     "type": "number",
     "maximum": 90,
     "minimum": -90
    },
    "lon": {
     "type": "number",
     "maximum": 180,
     "minimum": -180
    }
   },
   "description": "End of the corridor. Without it, from is treated as a single point.",
   "additionalProperties": false
  },
  "from": {
   "type": "object",
   "required": [
    "lat",
    "lon"
   ],
   "properties": {
    "lat": {
     "type": "number",
     "maximum": 90,
     "minimum": -90
    },
    "lon": {
     "type": "number",
     "maximum": 180,
     "minimum": -180
    }
   },
   "description": "Start of the corridor.",
   "additionalProperties": false
  },
  "vehicle": {
   "type": "object",
   "properties": {
    "hazmat": {
     "type": "boolean",
     "description": "Carrying dangerous goods."
    },
    "width_m": {
     "type": "number",
     "maximum": 8,
     "minimum": 0.5
    },
    "height_m": {
     "type": "number",
     "maximum": 10,
     "minimum": 0.5
    },
    "length_m": {
     "type": "number",
     "maximum": 40,
     "minimum": 1
    },
    "weight_t": {
     "type": "number",
     "maximum": 250,
     "minimum": 0.1
    },
    "axleload_t": {
     "type": "number",
     "maximum": 30,
     "minimum": 0.1
    }
   },
   "description": "The vehicle to judge the restrictions against. Anything omitted is not judged.",
   "additionalProperties": false
  },
  "corridor_km": {
   "type": "number",
   "default": 1,
   "maximum": 10,
   "minimum": 0.1,
   "description": "Half width of the corridor, or the radius around a single point."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/karte-halowerk-restricted-route-checker-846fca31/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from karte.halowerk.com](https://www.zero.xyz/host/karte.halowerk.com/llms.txt)