API Reference

Generate PDFs, manage documents and templates, and configure webhooks via REST API. Available on Business plan and above.

Base URL: https://quaterio.com/api/v1

Authentication

All API requests require a Bearer token in the Authorization header. Tokens use the q_ prefix and are verified via SHA-256 hash lookup.

# Include your API token in every request

curl https://quaterio.com/api/v1/documents \

-H "Authorization: Bearer q_your_api_token"

Generate API tokens in your Dashboard → Settings → API Tokens. API access requires a Business or Enterprise subscription.

PDF Generation

Generate PDFs from templates with variable replacement, raw HTML or Markdown. All endpoints accept page settings (margins, font family, columns, headers, footers) and support returnBlob: true for binary response.

POST/api/v1/generate/template

Generate a PDF from a template with variable replacement. Supports caching, print-ready output (CMYK, trim marks) and debug mode.

Show all 6 parameters

Parameter	Type	Description
`templateId`required	string	UUID of the template, or the custom ID you set in the dashboard (e.g. "monthly_invoice")
`variables`	object	Key-value pairs for template placeholders. Supports text, html, markdown, qrcode, barcode and formfield content types
`returnBlob`	boolean	Return binary PDF instead of download URL
`printReady`	object	Print-ready output: { cmyk, outlineFonts, trimMarks, bleedMm } (Business+ only)
`noCache`	boolean	Skip cache and regenerate
`debug`	boolean	Include debug information in response

curl -X POST https://quaterio.com/api/v1/generate/template \ -H "Authorization: Bearer q_..." \ -H "Content-Type: application/json" \ -d '{ "templateId": "monthly_invoice", "variables": { "company": "Acme Inc", "total": "$4,250.00" } }' # → { "ok": true, "data": { "downloadUrl": ".../invoice_en_a7f3b2c1.pdf" } }

POST/api/v1/generate/html

Generate a PDF from raw HTML. Accepts page settings for margins, font family, columns, headers and footers.

Show all 13 parameters

Parameter	Type	Description
`html`required	string	HTML content to render as PDF
`returnBlob`	boolean	Return binary PDF instead of download URL
`pageSize`	string	Page size preset: a4, letter, legal, a3, a5 (default: a4). Ignored when pageWidthMm/pageHeightMm are set
`pageWidthMm`	number	Custom page width in mm (50-1000). Use with pageHeightMm instead of pageSize
`pageHeightMm`	number	Custom page height in mm (50-2000). Use with pageWidthMm instead of pageSize
`margins`	object	Page margins in mm: { top, right, bottom, left } (each 0-100)
`styles`	object	Typography: { h1Size, h2Size, h3Size, h4Size, h5Size, h6Size, pSize, lineHeight }
`fontFamily`	string	Font family for the document (any Google Font name)
`columns`	number	Number of text columns, 1-4 (default: 1)
`header`	object	Header config: { content, isVisible, alignment, horizontalAlignment }
`footer`	object	Footer config: { content, isVisible, alignment, horizontalAlignment }
`language`	string	Language code, e.g. en, sv (default: en)
`printReady`	object	Print-ready output: { cmyk, outlineFonts, trimMarks, bleedMm } (Business+ only)

curl -X POST https://quaterio.com/api/v1/generate/html \ -H "Authorization: Bearer q_..." \ -H "Content-Type: application/json" \ -d '{ "html": "<h1>Hello World</h1><p>Your content here.</p>", "pageSize": "a4", "margins": { "top": 20, "right": 15, "bottom": 20, "left": 15 }, "fontFamily": "Inter", "columns": 1 }'

POST/api/v1/generate/markdown

Generate a PDF from Markdown. Converted to HTML internally, then rendered with the same engine.

Show all 13 parameters

Parameter	Type	Description
`markdown`required	string	Markdown content to render as PDF
`returnBlob`	boolean	Return binary PDF instead of download URL
`pageSize`	string	Page size preset: a4, letter, legal, a3, a5 (default: a4). Ignored when pageWidthMm/pageHeightMm are set
`pageWidthMm`	number	Custom page width in mm (50-1000). Use with pageHeightMm instead of pageSize
`pageHeightMm`	number	Custom page height in mm (50-2000). Use with pageWidthMm instead of pageSize
`margins`	object	Page margins in mm: { top, right, bottom, left } (each 0-100)
`styles`	object	Typography: { h1Size, h2Size, h3Size, h4Size, h5Size, h6Size, pSize, lineHeight }
`fontFamily`	string	Font family for the document (any Google Font name)
`columns`	number	Number of text columns, 1-4 (default: 1)
`header`	object	Header config: { content, isVisible, alignment, horizontalAlignment }
`footer`	object	Footer config: { content, isVisible, alignment, horizontalAlignment }
`language`	string	Language code, e.g. en, sv (default: en)
`printReady`	object	Print-ready output: { cmyk, outlineFonts, trimMarks, bleedMm } (Business+ only)

curl -X POST https://quaterio.com/api/v1/generate/markdown \ -H "Authorization: Bearer q_..." \ -H "Content-Type: application/json" \ -d '{ "markdown": "# Report\n\nQuarterly summary...", "pageSize": "letter", "margins": { "top": 25, "right": 20, "bottom": 25, "left": 20 }, "header": { "content": "Quarterly Report", "isVisible": true } }'

POST/api/v1/generate/batch

Generate multiple PDFs from one template. Each row provides its own set of variables. Returns per-row success/failure status.

Parameter	Type	Description
`templateId`required	string	UUID of the template, or the custom ID you set in the dashboard (e.g. "monthly_invoice")
`rows`required	array	Array of variable objects. Each entry generates one PDF with its own variables. Business: max 100 rows. Enterprise: max 1,000
`concurrency`	number	Parallel generation limit (default 5, max 20)

curl -X POST https://quaterio.com/api/v1/generate/batch \ -H "Authorization: Bearer q_..." \ -d '{ "templateId": "monthly_invoice", "rows": [ { "company": "Acme Inc", "total": "$1,000" }, { "company": "Globex Corp", "total": "$2,500" } ], "concurrency": 5 }'

Resources

Create, list, read and delete documents and templates. All list endpoints support pagination and language filtering.

GET/api/v1/documents

List all documents in your organization. Supports pagination and language filtering.

POST/api/v1/documents

Create a new document.

Parameter	Type	Description
`title`required	string	Document title
`language`	string	Language code (defaults to organization default)

GET/api/v1/documents/:id

Get a single document by ID.

DELETE/api/v1/documents/:id

Delete a document.

POST/api/v1/documents/:id/duplicate

Duplicate a document with optional title and language override.

Parameter	Type	Description
`title`	string	Title for the duplicate
`language`	string	Language for the duplicate

GET/api/v1/templates

List all templates in your organization. Supports pagination, language filtering, and ?include=schema to embed the variable list on each row (handy for agents that need to pick a template and bind data in one round trip).

POST/api/v1/templates

Create a new template.

Parameter	Type	Description
`name`required	string	Template name
`language`	string	Language code

GET/api/v1/templates/:id

Get a single template by ID.

GET/api/v1/templates/:id/schema

Get the variable schema for a template. Returns each placeholder name, its content type (text, html, markdown, qrcode, barcode, formfield), whether a default value is set (required = no default), and the number of occurrences. Use this so agents can bind their own data to your templates without reading the template source.

curl https://quaterio.com/api/v1/templates/<id>/schema \ -H "Authorization: Bearer q_..." # → { # "ok": true, # "data": { # "templateId": "...", # "name": "Monthly Invoice", # "language": "en", # "updatedAt": "2026-06-07T10:12:00.000Z", # "variables": [ # { "name": "customer_name", "contentType": "text", "required": true, "defaultValue": null, "occurrences": 2 }, # { "name": "terms_html", "contentType": "html", "required": false, "defaultValue": "<p>Standard terms apply.</p>", "occurrences": 1 }, # { "name": "tracking_qr", "contentType": "qrcode", "required": true, "defaultValue": null, "occurrences": 1, "options": { "size": 150 } } # ] # } # }

DELETE/api/v1/templates/:id

Delete a template.

POST/api/v1/templates/:id/duplicate

Duplicate a template with optional name and language override.

Parameter	Type	Description
`name`	string	Name for the duplicate
`language`	string	Language for the duplicate

Webhooks

Get notified when events happen. Register a URL and select which events to subscribe to. Every payload is HMAC-SHA256 signed so you can verify authenticity.

GET/api/v1/webhooks

List all webhooks in your organization.

POST/api/v1/webhooks

Create a new webhook. Returns the signing secret once. Payloads include X-Quaterio-Signature (HMAC-SHA256) and X-Quaterio-Event headers.

Parameter	Type	Description
`url`required	string	HTTPS URL to receive webhook events
`events`required	string[]	Events to subscribe to: document.created, document.updated, document.deleted, document.exported, template.created, template.updated, template.deleted, content.created, content.updated, content.deleted
`description`	string	Optional label for this webhook (max 500 chars)

curl -X POST https://quaterio.com/api/v1/webhooks \ -H "Authorization: Bearer q_..." \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/webhook", "events": ["document.exported", "template.created"], "description": "Production notifications" }' # → { "ok": true, "data": { "id": "...", "secret": "shown-only-once" } }

GET/api/v1/webhooks/:id

Get a single webhook by ID.

DELETE/api/v1/webhooks/:id

Delete a webhook.

Verifying webhook signatures

Each delivery includes two headers for verification:

Header	Description
`X-Quaterio-Signature`	HMAC-SHA256 of the raw body, prefixed with `sha256=`
`X-Quaterio-Event`	The event type, e.g. `document.exported`

const crypto = require('crypto'); const signature = req.headers['x-quaterio-signature']; const expected = 'sha256=' + crypto .createHmac('sha256', webhookSecret) .update(rawBody) .digest('hex'); const valid = crypto.timingSafeEqual( Buffer.from(signature), Buffer.from(expected), );

Pagination

List endpoints return paginated results. Use query parameters to control page size and offset.

Parameter	Default	Description
page	1	Page number
perPage	20	Items per page (max 100)
lang	—	Filter by language code (e.g. en, sv, de)

{ "ok": true, "data": [...], "pagination": { "totalItems": 42, "perPage": 20, "currentPage": 1, "totalPages": 3 } }

Errors

All errors return a consistent JSON structure with an error code and human-readable message.

{ "ok": false, "error": { "code": "VALIDATION_ERROR", "message": "templateId is required" } }

HTTP Status	Description
400	Validation error (missing or invalid parameters)
401	Missing or invalid API token
403	Insufficient tier (API requires Business or Enterprise)
404	Resource not found
500	Internal server error