Quickstart

curl -X POST https://api.platendoc.com/v1/generations \
  -H "Authorization: Bearer pdc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_01j8z...",
    "format": "pdf",
    "variables": {
      "customerName": "Acme Corp",
      "invoiceNumber": "INV-0042",
      "amount": "1,250.00"
    }
  }'

{
  "id": "gen_01j8z...",
  "status": "PENDING",
  "format": "PDF",
  "outputUrl": null,
  ...
}

curl https://api.platendoc.com/v1/generations/gen_01j8z... \
  -H "Authorization: Bearer pdc_live_YOUR_KEY"

{
  "id": "gen_01j8z...",
  "status": "COMPLETED",
  "outputUrl": "https://...",
  ...
}

curl -L "https://..." -o invoice.pdf

import fetch from 'node-fetch'

const API_KEY = process.env.PLATENDOC_API_KEY
const BASE = 'https://api.platendoc.com/v1'

async function generateDocument(templateId: string, variables: Record<string, unknown>) {
  // 1. Create generation
  const createRes = await fetch(`${BASE}/generations`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ templateId, format: 'pdf', variables }),
  })
  const { id } = await createRes.json()

  // 2. Poll until complete
  let generation
  for (let i = 0; i < 30; i++) {
    await new Promise((r) => setTimeout(r, 1000))
    const res = await fetch(`${BASE}/generations/${id}`, {
      headers: { Authorization: `Bearer ${API_KEY}` },
    })
    generation = await res.json()
    if (generation.status === 'COMPLETED' || generation.status === 'FAILED') break
  }

  if (generation.status !== 'COMPLETED') {
    throw new Error(`Generation failed: ${generation.error}`)
  }

  return generation.outputUrl
}

{
  "status": "FAILED",
  "error": "Template rendering failed: unknown variable 'customerNme'."
}