Skip to content
HALOWERK

Formatwerk

pdf print preflight

Parses the PDF with pdf-lib 1.17.1 and walks every page content stream and nested form XObject with an own interpreter (ISO 32000-2 §8 graphics state and colour spaces, §8.9 images incl. inline images). Effective image resolution = pixel size divided by the placed size in inches taken from the current transformation matrix (UserUnit included). Page boxes follow §14.11.2 (BleedBox and TrimBox default to the CropBox); bleed is measured per side in mm. A font counts as embedded when its.

POST https://format.halowerk.com/v1/pdf-print-preflight

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
content_base64stringNoThe PDF as base64 (a data: prefix and whitespace are tolerated); at most 10 MB decoded.
urlstringNoPublic http(s) URL of the PDF (at most 10 MB). Private, local and reserved addresses are refused.
bleed_mmnumberNoRequired bleed on every side in millimetres (0 disables the check).
min_ppiintegerNoEffective resolution below which colour and greyscale images get a warning.
min_ppi_errorintegerNoEffective resolution below which colour and greyscale images are an error.
min_ppi_line_artintegerNoEffective resolution below which 1-bit images get a warning.
min_line_width_ptnumberNoStroke width in points below which a line counts as hairline.
color_modestringNo"cmyk" warns about RGB and Lab colour; "any" only lists colour spaces.
pagesstringNoPage selection such as "1-3,7"; default all pages.
max_pagesintegerNoUpper limit of pages checked in one call.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "content_base64": {
      "type": "string",
      "minLength": 8,
      "maxLength": 13981016,
      "description": "The PDF as base64 (a data: prefix and whitespace are tolerated); at most 10 MB decoded."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the PDF (at most 10 MB). Private, local and reserved addresses are refused."
    },
    "bleed_mm": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "default": 3,
      "description": "Required bleed on every side in millimetres (0 disables the check)."
    },
    "min_ppi": {
      "type": "integer",
      "minimum": 72,
      "maximum": 1200,
      "default": 300,
      "description": "Effective resolution below which colour and greyscale images get a warning."
    },
    "min_ppi_error": {
      "type": "integer",
      "minimum": 36,
      "maximum": 600,
      "default": 150,
      "description": "Effective resolution below which colour and greyscale images are an error."
    },
    "min_ppi_line_art": {
      "type": "integer",
      "minimum": 150,
      "maximum": 2400,
      "default": 600,
      "description": "Effective resolution below which 1-bit images get a warning."
    },
    "min_line_width_pt": {
      "type": "number",
      "minimum": 0,
      "maximum": 2,
      "default": 0.25,
      "description": "Stroke width in points below which a line counts as hairline."
    },
    "color_mode": {
      "type": "string",
      "enum": [
        "cmyk",
        "any"
      ],
      "default": "cmyk",
      "description": "\"cmyk\" warns about RGB and Lab colour; \"any\" only lists colour spaces."
    },
    "pages": {
      "type": "string",
      "maxLength": 400,
      "pattern": "^\\s*\\d{1,5}(\\s*-\\s*\\d{1,5})?(\\s*,\\s*\\d{1,5}(\\s*-\\s*\\d{1,5})?){0,99}\\s*$",
      "description": "Page selection such as \"1-3,7\"; default all pages."
    },
    "max_pages": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 200,
      "description": "Upper limit of pages checked in one call."
    }
  }
}

Open original schema

Published input example

{
  "content_base64": "JVBERi0xLjcKJYGBgYEKCjUgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL0xlbmd0aCAxMDQKPj4Kc3RyZWFtCnicjYo7CoAwEET7PUVOEGZNdrM5hrVYKSKohZXXN1Gw0UIG5vOYneDZ4dJCcAd1fakj3ZBd8qwSJIaABFP9IsP23Ku/Z43qFpMXyRBhNmY0biUFfI7RjM1y0mA/Xyh0polaOgGiLCZlCmVuZHN0cmVhbQplbmRvYmoKCjYgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL1R5cGUgL09ialN0bQovTiA0Ci9GaXJzdCAyMAovTGVuZ3RoIDM3Ngo+PgpzdHJlYW0KeJzVU81OwzAMvvcpfIRL6/ynaJq0rSsHNDGNHRCIQ1mjqWg0qOuk8fY4zRhCAnGmqeXY/mzHccwAgYOUIMBYkKAEh9Eoydbvbw6yZbV1+yS7aeo9PJIVYQVPSTbzh7YHlozHyRd2VvXVzm+T6AQsgD8Ry87Xh43rYFTOyxLRIKKWRBqRF8RnRDkRJ5ls3NKeyMgTkc4IRDEhWxlJm+gT7ANWnfznxAmrA6aIWGmjfM4bcs1jDP7XefJxki18XVS9g4viiiPXjCHD4Xu4pOvoXNX7/1vccP7Gt79W+K3Pob2hyZ0Lb2DocrZye3/oNtT2gCs9WWhDbtn97fOL25zF+bG/vutDnqgIuoWrm2rqj/TCkBYdC6zB8M7WXfMaDQzDr1Gl3CiVo1KMWcbBKpZamxstjMkVNzq4TXfO1dHPpEwroaQQdA1Wa/aDRqNNqVwuNOcoDZcUVabEJeZSWsusDVEnbev7MAbDALQ9lR8kdRoKquQD5rfBUwplbmRzdHJlYW0KZW5kb2JqCgo3IDAgb2JqCjw8Ci9TaXplIDgKL1Jvb3QgMiAwIFIKL0luZm8gMyAwIFIKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL1R5cGUgL1hSZWYKL0xlbmd0aCAzOAovVyBbIDEgMiAyIF0KL0luZGV4IFsgMCA4IF0KPj4Kc3RyZWFtCnicFcSxDQAgCACwgomz/y/ewmUoHYrutJliymmFQ6hfXh5VbgOaCmVuZHN0cmVhbQplbmRvYmoKCnN0YXJ0eHJlZgo2NzEKJSVFT0Y=",
  "bleed_mm": 3
}

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 →