Data Sources
Batch Generation (Liquid)
Generate thousands of personalized PDFs in a single API call. Provide one HTML/Markdown template containing Liquid variables, alongside an array of JSON objects. The API will loop through the data, inject it into your template, and return a ZIP file containing all the generated PDFs.
Implementation Example
{
// 1. Enable Liquid Templating
"parse_liquid": true,
// 2. Your Template with Liquid {{ variables }}
"html": "<h1>Invoice for {{ customer_name }}</h1><p>Amount: {{ amount }}</p>",
// 3. Array of Data (Generates 2 PDFs in a ZIP)
"liquid_data": [
{ "customer_name": "Alice", "amount": "$120" },
{ "customer_name": "Bob", "amount": "$340" }
]
}
Parameters Explained
parse_liquid
Boolean flag to enable the Liquid rendering engine. Set this to
true to instruct the API to parse {{ variables }} inside your HTML or Markdown input.
liquid_data
An array of JSON objects. The API will generate one distinct PDF document for every object in this array. The final response will be a ZIP file containing all the generated PDFs.
delivery_mode
Required
Batch generation is strictly asynchronous. You MUST provide a valid async delivery mode (
webhook, s3, or google_storage) to receive the generated ZIP file upon completion. Synchronous modes like json are not permitted for Batch requests via the API.