Batch Processing

curl -X POST https://api.pdfbase.dev/v1/batches \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Idempotency-Key: invoices-2026-05" \
  -d '{
    "items": [
      { "template_id": "tpl_abc123", "data": { "number": "INV-001", "customer": "Acme" } },
      { "template_id": "tpl_abc123", "data": { "number": "INV-002", "customer": "Globex" } },
      { "template_id": "tpl_abc123", "data": { "number": "INV-003", "customer": "Initech" } }
    ]
  }'

{
  "results": [
    { "index": 0, "pdf_id": "pdf_a", "url": "..." },
    { "index": 1, "pdf_id": "pdf_b", "url": "..." }
  ]
}

{ "merged_pdf": { "id": "pdf_merged", "url": "...", "pages": 100 } }

{ "zip_url": "...", "zip_bytes": 3800000 }

const batch = await pdfbase.batches.create({ items: [...] })

// SDK convenience method — polls every 2s, returns when done
const result = await pdfbase.batches.poll(batch.id, {
  interval: 2000,
  timeout: 300000,
})

{
  "webhook_url": "https://your-app.com/webhooks/batch-done",
  "items": [...]
}

{
  "status": "completed",
  "total_items": 50,
  "completed_items": 48,
  "failed_items": 2,
  "results": [
    { "index": 0, "status": "completed", "pdf_id": "pdf_a", "url": "..." },
    { "index": 7, "status": "failed", "error": { "code": "timeout_exceeded" } },
    ...
  ]
}

{ "parallel": 10, "items": [...] }