Skip to content
HALOWERK

Ortwerk

shipping zone map

Expands "EU" to the 27 member states (europa.eu, retrieved 2026-11-01) minus per-zone exclusions, validates every ISO 3166-1 alpha-2 code (CLDR region names), rejects countries assigned to two zones, and lists unassigned neighbours. The map uses Natural Earth 1:50m country boundaries (public domain, coordinates rounded to 0.01°) projected with d3-geo (Mercator for Europe, Natural Earth for the world) and colours zones with a colour-blind-safe palette; a legend shows name, rate and number of.

POST https://ort.halowerk.com/v1/shipping-zone-map

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
zonesarrayYes
regionSee schemaNo
widthintegerNo
titlestringNo
include_geojsonbooleanNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "zones"
  ],
  "properties": {
    "zones": {
      "type": "array",
      "minItems": 1,
      "maxItems": 12,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "countries"
        ],
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40
          },
          "countries": {
            "type": "array",
            "minItems": 1,
            "maxItems": 250,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            },
            "description": "ISO codes; \"EU\" adds all 27 member states."
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            }
          },
          "rate": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000
          },
          "currency": {
            "type": "string",
            "pattern": "^[A-Z]{3}$",
            "default": "EUR"
          },
          "color": {
            "type": "string",
            "pattern": "^#[0-9A-Fa-f]{6}$"
          }
        }
      }
    },
    "region": {
      "enum": [
        "europe",
        "world"
      ],
      "default": "europe"
    },
    "width": {
      "type": "integer",
      "minimum": 300,
      "maximum": 1600,
      "default": 800
    },
    "title": {
      "type": "string",
      "maxLength": 80
    },
    "include_geojson": {
      "type": "boolean",
      "default": false
    }
  }
}

Open original schema

Published input example

{
  "zones": [
    {
      "name": "Germany",
      "countries": [
        "DE"
      ],
      "rate": 4.99
    },
    {
      "name": "EU",
      "countries": [
        "EU"
      ],
      "exclude": [
        "DE"
      ],
      "rate": 12.5
    },
    {
      "name": "Europe rest",
      "countries": [
        "CH",
        "NO",
        "GB"
      ],
      "rate": 19.9
    }
  ]
}

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 →