Skip to content
HALOWERK

Formatwerk

certificate batch

Parses CSV (delimiter detected) or JSON rows, fills {{column}} placeholders and typesets one framed certificate page per record in headless Chrome (scripts off, network blocked; system fonts cover Latin, Greek, Cyrillic, CJK). The name is fitted to the line width with font metrics; overflowing pages are shrunk once, otherwise rejected with row numbers. Optional serial numbers and verification codes (64 bits of SHA-256 over serial and row) in the manifest. Price covers up to 200 pages.

POST https://format.halowerk.com/v1/certificate-batch

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
csvstringNoCSV with a header row.
rowsarrayNo
delimiterstringNo
templateobjectYes
serialobjectNo
verification_codebooleanNo
page_sizestringNo
orientationstringNo
fontstringNo
accent_colorstringNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "template"
  ],
  "properties": {
    "csv": {
      "type": "string",
      "maxLength": 500000,
      "description": "CSV with a header row."
    },
    "rows": {
      "type": "array",
      "minItems": 1,
      "maxItems": 200,
      "items": {
        "type": "object",
        "additionalProperties": {
          "type": [
            "string",
            "number",
            "boolean",
            "null"
          ]
        }
      }
    },
    "delimiter": {
      "type": "string",
      "enum": [
        "auto",
        ",",
        ";",
        "\t"
      ],
      "default": "auto"
    },
    "template": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "title"
      ],
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "intro": {
          "type": "string",
          "maxLength": 300
        },
        "recipient": {
          "type": "string",
          "maxLength": 200,
          "default": "{{name}}"
        },
        "body": {
          "type": "string",
          "maxLength": 2000
        },
        "place_date": {
          "type": "string",
          "maxLength": 200
        },
        "issuer": {
          "type": "string",
          "maxLength": 200
        },
        "signers": {
          "type": "array",
          "maxItems": 3,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 80
              },
              "role": {
                "type": "string",
                "maxLength": 80
              }
            }
          }
        }
      }
    },
    "serial": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "prefix": {
          "type": "string",
          "maxLength": 30,
          "pattern": "^[A-Za-z0-9 ._/-]*$"
        },
        "start": {
          "type": "integer",
          "minimum": 0,
          "maximum": 999999999,
          "default": 1
        },
        "digits": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "default": 4
        }
      }
    },
    "verification_code": {
      "type": "boolean",
      "default": true
    },
    "page_size": {
      "type": "string",
      "enum": [
        "A4",
        "Letter"
      ],
      "default": "A4"
    },
    "orientation": {
      "type": "string",
      "enum": [
        "landscape",
        "portrait"
      ],
      "default": "landscape"
    },
    "font": {
      "type": "string",
      "enum": [
        "serif",
        "sans"
      ],
      "default": "serif"
    },
    "accent_color": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "default": "#7a5c1e"
    }
  }
}

Open original schema

Published input example

{
  "csv": "name;kurs;datum\nMietpartei Nord;Erste Hilfe;12.10.2026\nEinkaufsteam Nord;Erste Hilfe;12.10.2026",
  "template": {
    "title": "Teilnahmebescheinigung",
    "intro": "Hiermit wird bestätigt, dass",
    "body": "am {{datum}} am Kurs „{{kurs}}“ teilgenommen hat.",
    "place_date": "Gronau, {{datum}}",
    "signers": [
      {
        "name": "Schulungsleitung",
        "role": "Kursleitung"
      }
    ]
  },
  "serial": {
    "prefix": "TB-2026-",
    "start": 1,
    "digits": 4
  }
}

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 →