Skip to content
HALOWERK

Formatwerk

label sheet

Fills {{column}} line templates per record (empty lines dropped, as for addresses), fits the text into the printable label area using font metrics and places every label at its exact millimetre position on sheets rendered by headless Chrome (scripts off, network blocked, full Unicode). Presets come from the gLabels template database (GPL-3.0, values unchanged; check them against your packaging); other sheets as a custom grid. Start position, copies, sender line, test outlines.

POST https://format.halowerk.com/v1/label-sheet

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
csvstringNo
rowsarrayNo
delimiterstringNo
formatstringNo
customobjectNo
linesarrayNoLine templates with {{column}}; default: every column on its own line.
sender_linestringNoSmall return-address line at the top of each label.
start_labelintegerNoFirst free label on the first sheet (row-major, 1-based).
copiesintegerNo
font_size_ptnumberNo
padding_mmnumberNo
vertical_alignstringNo
outlinebooleanNoDraw label borders for a test print.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "csv": {
      "type": "string",
      "maxLength": 1000000
    },
    "rows": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2000,
      "items": {
        "type": "object",
        "additionalProperties": {
          "type": [
            "string",
            "number",
            "null"
          ]
        }
      }
    },
    "delimiter": {
      "type": "string",
      "enum": [
        "auto",
        ",",
        ";",
        "\t"
      ],
      "default": "auto"
    },
    "format": {
      "type": "string",
      "enum": [
        "zweckform-3474",
        "zweckform-3481",
        "zweckform-3669",
        "avery-l7162",
        "avery-l7163",
        "avery-l7165"
      ]
    },
    "custom": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "page_width_mm",
        "page_height_mm",
        "columns",
        "rows",
        "label_width_mm",
        "label_height_mm",
        "offset_left_mm",
        "offset_top_mm"
      ],
      "properties": {
        "page_width_mm": {
          "type": "number",
          "minimum": 50,
          "maximum": 500
        },
        "page_height_mm": {
          "type": "number",
          "minimum": 50,
          "maximum": 500
        },
        "columns": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10
        },
        "rows": {
          "type": "integer",
          "minimum": 1,
          "maximum": 40
        },
        "label_width_mm": {
          "type": "number",
          "minimum": 10,
          "maximum": 500
        },
        "label_height_mm": {
          "type": "number",
          "minimum": 5,
          "maximum": 500
        },
        "offset_left_mm": {
          "type": "number",
          "minimum": 0,
          "maximum": 200
        },
        "offset_top_mm": {
          "type": "number",
          "minimum": 0,
          "maximum": 200
        },
        "pitch_x_mm": {
          "type": "number",
          "minimum": 10,
          "maximum": 500
        },
        "pitch_y_mm": {
          "type": "number",
          "minimum": 5,
          "maximum": 500
        }
      }
    },
    "lines": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "description": "Line templates with {{column}}; default: every column on its own line."
    },
    "sender_line": {
      "type": "string",
      "maxLength": 120,
      "description": "Small return-address line at the top of each label."
    },
    "start_label": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "default": 1,
      "description": "First free label on the first sheet (row-major, 1-based)."
    },
    "copies": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 1
    },
    "font_size_pt": {
      "type": "number",
      "minimum": 6,
      "maximum": 16,
      "default": 11
    },
    "padding_mm": {
      "type": "number",
      "minimum": 0,
      "maximum": 15,
      "default": 4
    },
    "vertical_align": {
      "type": "string",
      "enum": [
        "top",
        "middle"
      ],
      "default": "middle"
    },
    "outline": {
      "type": "boolean",
      "default": false,
      "description": "Draw label borders for a test print."
    }
  }
}

Open original schema

Published input example

{
  "csv": "name;street;zip;city\nMietpartei Nord;Hauptstraße 5;10115;Berlin",
  "format": "zweckform-3474",
  "lines": [
    "{{name}}",
    "{{street}}",
    "{{zip}} {{city}}"
  ]
}

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 →