Skip to content
HALOWERK

Formatwerk

gaeb parse

Reads 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. Returns project, award and BoQ information, the breakdown (BoQBkdn) with the OZ mask, all categories (lots,.

POST https://format.halowerk.com/v1/gaeb-parse

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
xmlstringNoGAEB DA XML file content (X80-X87) as text.
content_base64stringNoGAEB DA XML file (.X81, .X83, .X84 ...) as base64; at most 10 MB decoded. The encoding follows the BOM or XML declaration.
include_long_textbooleanNoInclude long texts (DetailTxt) of items.
validate_schemabooleanNoValidate against the official GAEB XSD.
excelbooleanNoAlso return an .xlsx workbook as base64.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "xml": {
      "type": "string",
      "minLength": 20,
      "maxLength": 10485760,
      "description": "GAEB DA XML file content (X80-X87) as text."
    },
    "content_base64": {
      "type": "string",
      "minLength": 8,
      "maxLength": 13981016,
      "description": "GAEB DA XML file (.X81, .X83, .X84 ...) as base64; at most 10 MB decoded. The encoding follows the BOM or XML declaration."
    },
    "include_long_text": {
      "type": "boolean",
      "default": true,
      "description": "Include long texts (DetailTxt) of items."
    },
    "validate_schema": {
      "type": "boolean",
      "default": true,
      "description": "Validate against the official GAEB XSD."
    },
    "excel": {
      "type": "boolean",
      "default": false,
      "description": "Also return an .xlsx workbook as base64."
    }
  }
}

Open original schema

Published input example

{
  "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>"
}

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 →