Skip to content
HALOWERK

Signalwerk

delivery zone check

Finds the delivery-area statements on a page or in a text (sections around Liefergebiet, liefern, Lieferung, Versand) and extracts five-digit postcodes, postcode ranges (48599–48619), postcode prefixes (485xx, 48*), town names, radius statements ("im Umkreis von 15 km") and nationwide statements. The target is a postcode and/or town; its municipalities come from official BKG/Destatis data intersected with OSM postcode areas (daten/H02). Radius statements are checked against the distance.

POST https://signal.halowerk.com/v1/delivery-zone-check

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
target_plzstringNoDelivery address postcode.
target_townstringNoDelivery address town (optional with target_plz).
urlstringNoPublic page to fetch (robots.txt respected).
htmlstringNoAlready loaded HTML (nothing is fetched).
base_urlstringNoURL the HTML was loaded from (required with html).
textstringNoAlternatively the delivery-area text.
business_plzstringNoBusiness location for radius statements.
business_latnumberNo
business_lonnumberNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "target_plz": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "Delivery address postcode."
    },
    "target_town": {
      "type": "string",
      "maxLength": 80,
      "description": "Delivery address town (optional with target_plz)."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public page to fetch (robots.txt respected)."
    },
    "html": {
      "type": "string",
      "minLength": 20,
      "maxLength": 3000000,
      "description": "Already loaded HTML (nothing is fetched)."
    },
    "base_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "URL the HTML was loaded from (required with html)."
    },
    "text": {
      "type": "string",
      "minLength": 10,
      "maxLength": 50000,
      "description": "Alternatively the delivery-area text."
    },
    "business_plz": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "Business location for radius statements."
    },
    "business_lat": {
      "type": "number",
      "minimum": 47,
      "maximum": 55.2
    },
    "business_lon": {
      "type": "number",
      "minimum": 5.5,
      "maximum": 15.5
    }
  }
}

Open original schema

Published input example

{
  "target_plz": "48599",
  "text": "Unser Liefergebiet: Wir liefern in die PLZ 48599, 48683 und 48691 sowie nach Heek."
}

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 →