format.halowerk.com

Checks and payment terms on this page refer to the first endpoint's example. Other endpoints have not been checked individually.

Base URLhttps://format.halowerk.com/v1

• POST/certificate-batch$0.01Parses 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.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/certificate-batch' \
    -H 'Content-Type: application/json' \
    -d '{"csv":"name;kurs;datum\nErika Mustermann;Erste Hilfe;12.10.2026\nMax Muster;Erste Hilfe;12.10.2026","serial":{"start":1,"digits":4,"prefix":"TB-2026-"},"template":{"body":"am {{datum}} am Kurs „{{kurs}}“ teilgenommen hat.","intro":"Hiermit wird bestätigt, dass","title":"Teilnahmebescheinigung","signers":[{"name":"Daniel Beispiel","role":"Kursleitung"}],"place_date":"Gronau, {{datum}}"}}'

• POST/contract-dates-ics$0.005Extracts start date, initial term or fixed end date, renewal (fixed periods or indefinite), notice period and its reference date (end of term, month, quarter, year) and dated deadlines from the text with German and English patterns; overrides can correct or replace each value. Terms run from the start of the first day (§ 187 Abs. 2 BGB) and end with the day before the corresponding day (§ 188 Abs. 2, 3 BGB; § 189 for half years).
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/contract-dates-ics' \
    -H 'Content-Type: application/json' \
    -d '{"text":"§ 2 Laufzeit\n(1) Der Vertrag beginnt am 01.01.2025 und hat eine Mindestlaufzeit von 24 Monaten.\n(2) Er verlängert sich automatisch um jeweils 12 Monate, wenn er nicht mit einer Frist von drei Monaten zum Ende der jeweiligen Laufzeit gekündigt wird.","reference_date":"2026-11-01"}'

• POST/contract-parties$0.005Locates the party block after "zwischen"/"between" (up to the first clause, preamble or "agree as follows"), splits it at the separating "und"/"and" lines or role definitions and reads per party: name, legal form (list of German, Austrian, Swiss, EU, UK and US forms such as GmbH, UG (haftungsbeschränkt), GmbH & Co.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/contract-parties' \
    -H 'Content-Type: application/json' \
    -d '{"text":"Vertrag\n\nzwischen\n\nMuster Logistik GmbH, Hafenstraße 12, 48599 Gronau\n– nachfolgend „Auftraggeber“ –\n\nund\n\nNetzwerk Service AG, Industriestraße 5, 20095 Hamburg\n– nachfolgend „Auftragnehmer“ –\n\n§ 1 Gegenstand\nDer Auftragnehmer betreibt die Server des Auftraggebers."}'

• POST/gaeb-generate$0.01Builds an X83 (Angebotsaufforderung, prices are not part of X83) from categories (lots and hierarchy levels with labels) and items with item number (OZ), short and long text, quantity, unit and the item kinds lump sum, provisional with/without total, alternative group/serial and quantity to be entered by the bidder (GAEB DA XML 3.3 Fachdokumentation 2023-01 (© DIN e.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/gaeb-generate' \
    -H 'Content-Type: application/json' \
    -d '{"boq":{"name":"LV 1","label":"Painting works"},"date":"2026-11-01","items":[{"oz":"01.0010","unit":"m2","quantity":120,"short_text":"Wall paint, two coats"}],"categories":[{"oz":"01","label":"Interior walls"}]}'

• POST/gaeb-parse$0.01Reads GAEB DA XML 3.2 and 3.3 exchange phases X80-X87 (GAEB DA XML 3.3 Fachdokumentation 2023-01 (© DIN e. V., Gemeinsamer Ausschuss Elektronik im Bauwesen) and the XSD schemas 3.3 (2021-05) and 3.2 (2013-10), https://www.gaeb.de/de/service/downloads/gaeb-datenaustausch/ (checked 2026-11-01)). XML is parsed without DTD or entity support (DOCTYPE is rejected) and limited to 10 MB.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/gaeb-parse' \
    -H 'Content-Type: application/json' \
    -d '{"xml":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><GAEB xmlns=\"http://www.gaeb.de/GAEB_DA_XML/DA83/3.3\"><GAEBInfo><Version>3.3</Version><VersDate>2021-05</VersDate><Date>2026-11-01</Date></GAEBInfo><Award><DP>83</DP><BoQ ID=\"B1\"><BoQInfo><Name>LV 1</Name><LblBoQ>Painting</LblBoQ><OutlCompl>OutTxt</OutlCompl><BoQBkdn><Type>Item</Type><Length>4</Length><Num>Yes</Num></BoQBkdn></BoQInfo><BoQBody><Itemlist><Item ID=\"I1\" RNoPart=\"10\"><Qty>120.000</Qty><QU>m2</QU><Description><OutlineText><OutlTxt><TextOutlTxt><p><span>Wall paint, two coats</span></p></TextOutlTxt></OutlTxt></OutlineText></Description></Item></Itemlist></BoQBody></BoQ></Award></GAEB>"}'

• POST/graphviz-render$0.004Graphviz compiled to WebAssembly (@hpcc-js/wasm-graphviz 1.30) runs inside a sandboxed Chrome renderer with network blocked, so a pathological graph cannot exhaust the API process. Syntax errors return the Graphviz message; file-reading attributes (image, shapefile, imagepath) and javascript: links are rejected. Node, edge and cluster counts come from the SVG; PNG is rasterised by Chrome.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/graphviz-render' \
    -H 'Content-Type: application/json' \
    -d '{"dot":"digraph G { rankdir=LR; order -> invoice -> payment; order -> shipment; }","engine":"dot"}'

• POST/html-to-pdf$0.005Prints HTML/CSS with headless Chrome 148 (puppeteer-core) in a fresh incognito context per call. Scripts in the document are disabled and every network request is blocked (only inline and data: resources), so no foreign URL is fetched; blocked requests are counted. Page size (ISO A3-A5, Letter, Legal, custom or CSS @page), margins, landscape, scale, page ranges, bookmarks, header/footer with {page}/{pages}/{title}/{date}. Limits: 3 MB HTML, 500 pages, 30 MB PDF.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/html-to-pdf' \
    -H 'Content-Type: application/json' \
    -d '{"html":"<h1>Delivery note 4711</h1><p>2 × pressure sensor</p>","footer":{"right":"Page {page} of {pages}"},"page_size":"A4"}'

• POST/label-sheet$0.005Fills {{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.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/label-sheet' \
    -H 'Content-Type: application/json' \
    -d '{"csv":"name;street;zip;city\nErika Mustermann;Hauptstraße 5;10115;Berlin","lines":["{{name}}","{{street}}","{{zip}} {{city}}"],"format":"zweckform-3474"}'

• POST/markdown-slides$0.005Splits Markdown into slides at --- lines (fenced code respected) or at headings, extracts speaker notes (lines after Note:/Notes: and HTML comments), converts slides with marked (raw HTML shown as text, only http/https/mailto links and data: images) and prints them with headless Chrome at 1280x720 or 1024x768 px per slide (scripts off, network blocked). Overfull slides are measured and scaled down to at most 50 %; slides that still overflow are reported. PDF only, no PPTX.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/markdown-slides' \
    -H 'Content-Type: application/json' \
    -d '{"aspect":"16:9","markdown":"# Agenda\n\n- Status\n- Next steps\n\n---\n\n# Status\n\nAll sensors online.\n\nNote: mention the outage on Monday"}'

• POST/mermaid-render$0.005Runs mermaid 12.2 from node_modules (no CDN) in a fresh incognito Chrome context with all network requests blocked, initialised with securityLevel strict (labels sanitised, no click callbacks, no HTML labels) and deterministic ids; directives cannot lift the protected security keys. Syntax errors return the parser message. PNG is rasterised by Chrome from the SVG.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/mermaid-render' \
    -H 'Content-Type: application/json' \
    -d '{"code":"flowchart TD\n  A[Order received] --> B{Paid?}\n  B -->|yes| C[Ship]\n  B -->|no| D[Send reminder]","format":"svg"}'

• POST/nda-terms$0.005Reads PDF (pdf.js text layer), DOCX (WordprocessingML: paragraphs, tables, numbering, headings) or text, tracks clause headings (§, Art., numbered) and applies disclosed German and English patterns sentence by sentence: NDA type (gegenseitig/mutual vs.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/nda-terms' \
    -H 'Content-Type: application/json' \
    -d '{"text":"Gegenseitige Geheimhaltungsvereinbarung\n\n§ 4 Laufzeit\nDiese Vereinbarung hat eine Laufzeit von zwei Jahren.\n\n§ 5 Vertragsstrafe\nFür jeden Fall der Zuwiderhandlung zahlt die verletzende Partei eine Vertragsstrafe in Höhe von 10.000,00 EUR.\n\n§ 7 Gerichtsstand\nAusschließlicher Gerichtsstand ist Düsseldorf."}'

• POST/obligation-register$0.005Every sentence is scanned with disclosed German and English modal patterns: obligations (verpflichtet sich, ist verpflichtet, hat … zu, muss, obliegt, schuldet, stellt sicher, gewährleistet; shall, must, agrees to, undertakes to), prohibitions (darf … nicht, ist untersagt, hat zu unterlassen; shall not, must not, may not), restrictions (darf nur; may only) and permissions/rights (ist berechtigt, hat das Recht, darf, kann; may, is entitled to).
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/obligation-register' \
    -H 'Content-Type: application/json' \
    -d '{"text":"§ 1 Pflichten\n(1) Der Auftragnehmer verpflichtet sich, die Software bis zum 31.03.2027 zu liefern.\n(2) Der Auftraggeber ist berechtigt, die Leistungen zu prüfen."}'

• POST/pdf-compress-to-size$0.005Measures the largest placed size of every image XObject from the page content (pdf-lib 1.17.1 plus own content interpreter) and derives its effective resolution. Lossless steps come first: uncompressed streams are Flate-compressed, page thumbnails optionally dropped, unreachable objects removed and objects packed into object streams.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/pdf-compress-to-size' \
    -H 'Content-Type: application/json' \
    -d '{"target_bytes":100000,"content_base64":"JVBERi0xLjcKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvQWNyb0Zvcm08PC9GaWVsZHNbNCAwIFIgNSAwIFJdPj4+PgplbmRvYmoKMiAwIG9iago8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PgplbmRvYmoKMyAwIG9iago8PC9UeXBlL1BhZ2UvUGFyZW50IDIgMCBSL01lZGlhQm94WzAgMCAzMDAgMjAwXS9Bbm5vdHNbNCAwIFIgNSAwIFJdPj4KZW5kb2JqCjQgMCBvYmoKPDwvVHlwZS9Bbm5vdC9TdWJ0eXBlL1dpZGdldC9GVC9UeC9UKG5hbWUpL1RVKEZ1bGwgbmFtZSkvTWF4TGVuIDQwL0ZmIDIvUmVjdFsyMCAxNTAgMjIwIDE2OF0vUCAzIDAgUj4+CmVuZG9iago1IDAgb2JqCjw8L1R5cGUvQW5ub3QvU3VidHlwZS9XaWRnZXQvRlQvQ2gvVChjb3VudHJ5KS9GZiAxMzEwNzIvT3B0WyhERSkoQVQpKENIKV0vVihERSkvRFYoREUpL1JlY3RbMjAgMTIwIDgwIDEzOF0vUCAzIDAgUj4+CmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA4NyAwMDAwMCBuIAowMDAwMDAwMTM4IDAwMDAwIG4gCjAwMDAwMDAyMjMgMDAwMDAgbiAKMDAwMDAwMDM0MSAwMDAwMCBuIAp0cmFpbGVyCjw8L1NpemUgNi9Sb290IDEgMCBSPj4Kc3RhcnR4cmVmCjQ3MwolJUVPRgo="}'

• POST/pdf-form-schema$0.003Walks the AcroForm field tree with pdf-lib 1.17.1 (ISO 32000-2 §12.7.4, inheritable FT/Ff/V/DV/Opt/MaxLen) and maps every terminal field to a schema property named with its fully qualified name: text fields to strings with maxLength, number-formatted fields to numbers, checkboxes to booleans (or their on/Off states), radio groups and combo boxes to enums of export values (radio states resolved through /Opt indices), editable combos to strings with examples, multi-select lists to arrays with…
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/pdf-form-schema' \
    -H 'Content-Type: application/json' \
    -d '{"content_base64":"JVBERi0xLjcKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvQWNyb0Zvcm08PC9GaWVsZHNbNCAwIFIgNSAwIFJdPj4+PgplbmRvYmoKMiAwIG9iago8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PgplbmRvYmoKMyAwIG9iago8PC9UeXBlL1BhZ2UvUGFyZW50IDIgMCBSL01lZGlhQm94WzAgMCAzMDAgMjAwXS9Bbm5vdHNbNCAwIFIgNSAwIFJdPj4KZW5kb2JqCjQgMCBvYmoKPDwvVHlwZS9Bbm5vdC9TdWJ0eXBlL1dpZGdldC9GVC9UeC9UKG5hbWUpL1RVKEZ1bGwgbmFtZSkvTWF4TGVuIDQwL0ZmIDIvUmVjdFsyMCAxNTAgMjIwIDE2OF0vUCAzIDAgUj4+CmVuZG9iago1IDAgb2JqCjw8L1R5cGUvQW5ub3QvU3VidHlwZS9XaWRnZXQvRlQvQ2gvVChjb3VudHJ5KS9GZiAxMzEwNzIvT3B0WyhERSkoQVQpKENIKV0vVihERSkvRFYoREUpL1JlY3RbMjAgMTIwIDgwIDEzOF0vUCAzIDAgUj4+CmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA4NyAwMDAwMCBuIAowMDAwMDAwMTM4IDAwMDAwIG4gCjAwMDAwMDAyMjMgMDAwMDAgbiAKMDAwMDAwMDM0MSAwMDAwMCBuIAp0cmFpbGVyCjw8L1NpemUgNi9Sb290IDEgMCBSPj4Kc3RhcnR4cmVmCjQ3MwolJUVPRgo="}'

• POST/quote-compare$0.004Each offer line is converted to a price per requested unit (count, mass, length, area, volume, time; price_per for prices per 100 or 1000 units; units of different dimensions are rejected) and to the base currency with caller-supplied rates (no external rates are fetched).
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/quote-compare' \
    -H 'Content-Type: application/json' \
    -d '{"items":[{"id":"A","unit":"pcs","quantity":100}],"offers":[{"lines":[{"item_id":"A","unit_price":1.2}],"supplier":"Alpha"},{"lines":[{"item_id":"A","price_per":100,"unit_price":110}],"shipping":5,"supplier":"Beta"}]}'

• POST/sla-extract$0.005German and English patterns over sentences and DOCX table rows: availability percentages next to Verfügbarkeit/availability/uptime with the measurement period (calendar month, quarter, year, week); the permitted downtime is computed as (100 % - availability) x period length for a week, 30- and 31-day months and a 365-day year.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/sla-extract' \
    -H 'Content-Type: application/json' \
    -d '{"text":"§ 3 Service Level\n(1) Der Auftragnehmer gewährleistet eine Verfügbarkeit von 99,5 % im Kalendermonat.\n(2) Priorität 1: Reaktionszeit 30 Minuten, Wiederherstellungszeit 4 Stunden."}'

• POST/tender-checklist$0.005Rule-based reading of award documents under the Vergabeverordnung (Vergabeverordnung (VgV) 2016, https://www.gesetze-im-internet.de/vgv_2016/ (checked 2026-11-01), text checked 2026-11-12) and the UVgO (Unterschwellenvergabeordnung (UVgO) 2017, BAnz AT 07.02.2017 B1, text https://www.bmwk.de/Redaktion/DE/Downloads/U/unterschwellenvergabeordnung-uvgo.pdf (checked 2026-11-01)).
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/tender-checklist' \
    -H 'Content-Type: application/json' \
    -d '{"text":"Offenes Verfahren nach § 15 VgV. Die Angebotsfrist endet am 07.04.2026 um 10:00 Uhr. Mit dem Angebot ist ein Auszug aus dem Handelsregister vorzulegen, nicht älter als 3 Monate.","publication_date":"2026-03-02"}'

• POST/vega-render$0.005Compiles Vega-Lite 6.5 to Vega 6.4 and renders to SVG with the string renderer (no canvas); PNG comes from the Chrome canvas. Both libraries run from node_modules inside a sandboxed Chrome renderer with network blocked, so Vega expressions never run in the API process. Data must be inline: any url is rejected and loader access is blocked and reported. Returns size, mark item count and warnings.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/vega-render' \
    -H 'Content-Type: application/json' \
    -d '{"spec":{"data":{"values":[{"month":"Jan","revenue":120},{"month":"Feb","revenue":180}]},"mark":"bar","encoding":{"x":{"type":"nominal","field":"month"},"y":{"type":"quantitative","field":"revenue"}}}}'

• POST/xrechnung-generate$0.005Builds an EN 16931 / XRechnung 3.0 invoice in UBL 2.1 or UN/CEFACT CII syntax with seller and buyer electronic addresses, contact, payment means (SEPA credit transfer with IBAN), VAT breakdown per category and rate, and totals rounded per EN 16931 rules (line net = quantity × price, VAT per category = base × rate). Every invoice is checked with the KoSIT validator 1.6.3 and the XRechnung configuration 3.0.2; invoices that are not accepted are not charged and the validator messages are returned.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/xrechnung-generate' \
    -H 'Content-Type: application/json' \
    -d '{"buyer":{"city":"Münster","name":"Beispielbehörde","street":"Amtsweg 2","country":"DE","postcode":"48143","electronic_scheme":"0204","electronic_address":"991-33333TEST-33"},"lines":[{"name":"Sensor maintenance","quantity":3,"vat_rate":19,"unit_code":"HUR","unit_price":95},{"name":"Technical handbook","quantity":1,"vat_rate":7,"unit_code":"C62","unit_price":20}],"number":"RE-2026-0042","seller":{"city":"Gronau","name":"Beispiel Manufaktur GmbH","street":"Musterweg 1","vat_id":"DE123456788","country":"DE","postcode":"48599","contact_name":"Buchhaltung","contact_email":"[email protected]","contact_phone":"+49 2562 0000","electronic_address":"[email protected]"},"syntax":"ubl","payment":{"iban":"DE89370400440532013000","terms":"Payable within 14 days without deduction.","means_code":"58"},"due_date":"2026-11-13","issue_date":"2026-10-30","delivery_date":"2026-10-28","buyer_reference":"991-33333TEST-33"}'

• POST/zugferd-generate$0.005Builds the structured invoice as XRechnung 3.0 in UN/CEFACT CII syntax, validates it with the KoSIT validator 1.6.3 (XRechnung configuration 3.0.2) and only then creates the hybrid PDF: PDF/A-3b with embedded fonts (Liberation Sans, OFL) and sRGB output intent, XMP metadata with the Factur-X extension schema (conformance level XRECHNUNG), and the XML attached as xrechnung.xml with AFRelationship Alternative, as required for the ZUGFeRD 2.3 profile XRECHNUNG.
  Example

  curl -i -X POST 'https://format.halowerk.com/v1/zugferd-generate' \
    -H 'Content-Type: application/json' \
    -d '{"buyer":{"city":"Münster","name":"Beispielbehörde","street":"Amtsweg 2","country":"DE","postcode":"48143","electronic_scheme":"0204","electronic_address":"991-33333TEST-33"},"lines":[{"name":"Sensor maintenance","quantity":3,"vat_rate":19,"unit_code":"HUR","unit_price":95},{"name":"Technical handbook","quantity":1,"vat_rate":7,"unit_code":"C62","unit_price":20}],"number":"RE-2026-0042","seller":{"city":"Gronau","name":"Beispiel Manufaktur GmbH","street":"Musterweg 1","vat_id":"DE123456788","country":"DE","postcode":"48599","contact_name":"Buchhaltung","contact_email":"[email protected]","contact_phone":"+49 2562 0000","electronic_address":"[email protected]"},"payment":{"iban":"DE89370400440532013000","terms":"Payable within 14 days without deduction.","means_code":"58"},"due_date":"2026-11-13","language":"de","issue_date":"2026-10-30","delivery_date":"2026-10-28","buyer_reference":"991-33333TEST-33"}'

A dash means the listing gives no price or method. {Braces} mark a value you fill in. Copy buttons copy an example URL.