API Documentation

{
  "data": {
    "id": "doc_abc123",
    "status": "completed",
    "download_url": "https://rendoc.dev/api/v1/documents/doc_abc123",
    "file_name": "rendoc-1711234567890.pdf",
    "file_size": 15234,
    "page_count": 1,
    "created_at": "2026-03-24T10:30:00.000Z",
    "expires_at": "2026-03-31T10:30:00.000Z"
  }
}

Authorization: Bearer rd_live_your_key_here

POST https://rendoc.dev/api/v1/documents/generate
Content-Type: application/json
Authorization: Bearer rd_live_your_key_here

{
  "template": {
    "markup": "<div style='font-family: sans-serif; padding: 40px;'><h1>Invoice #{{invoice_number}}</h1><p>Bill to: {{client_name}}</p><p>Amount: ${{amount}}</p><p>Due: {{due_date}}</p></div>",
    "paper_size": "A4",
    "orientation": "portrait"
  },
  "data": {
    "invoice_number": "INV-001",
    "client_name": "Acme Corp",
    "amount": "1,250.00",
    "due_date": "2026-04-15"
  },
  "options": {
    "filename": "invoice-001.pdf",
    "metadata": { "client_id": "acme-001" }
  }
}

POST https://rendoc.dev/api/v1/documents/generate
Content-Type: application/json
Authorization: Bearer rd_live_your_key_here

{
  "template_id": "clx1abc23def456",
  "data": {
    "company": "Acme Corp",
    "items": [
      { "name": "Consulting", "hours": 10, "rate": 150 },
      { "name": "Development", "hours": 20, "rate": 200 }
    ],
    "total": 5500
  }
}

{
  "data": {
    "id": "doc_abc123",
    "status": "completed",
    "download_url": "https://rendoc.dev/api/v1/documents/doc_abc123",
    "file_name": "invoice-001.pdf",
    "file_size": 24512,
    "page_count": 1,
    "created_at": "2026-03-24T10:30:00.000Z",
    "expires_at": "2026-03-31T10:30:00.000Z"
  }
}

{
  "data": {
    "id": "doc_abc123",
    "status": "completed",
    "download_url": "https://signed-url.blob.vercel-storage.com/...",
    "file_name": "invoice-001.pdf",
    "file_size": 24512,
    "page_count": 1,
    "template_id": "clx1abc23def456",
    "metadata": { "client_id": "acme-001" },
    "created_at": "2026-03-24T10:30:00.000Z",
    "expires_at": "2026-03-31T10:30:00.000Z"
  }
}

curl https://rendoc.dev/api/v1/documents/doc_abc123 \
  -H "Authorization: Bearer rd_live_your_key_here" \
  -H "Accept: application/pdf" \
  -o invoice.pdf

{
  "data": {
    "api_keys": [
      {
        "id": "key_abc123",
        "name": "Production",
        "prefix": "rd_live_a1b2",
        "scopes": ["documents:write", "documents:read", "templates:read"],
        "is_active": true,
        "last_used": "2026-03-24T09:15:00.000Z",
        "expires_at": null,
        "created_at": "2026-03-01T10:00:00.000Z"
      }
    ]
  }
}

{
  "data": {
    "plan": "starter",
    "period": { "year": 2026, "month": 3 },
    "usage": {
      "documents": 342,
      "pages": 1205,
      "limit": 1000,
      "remaining": 658,
      "percentage": 34
    },
    "daily": [
      { "day": 1, "documents": 12, "pages": 45 },
      { "day": 2, "documents": 18, "pages": 62 }
    ]
  }
}

{
  "mcpServers": {
    "rendoc": {
      "command": "npx",
      "args": ["tsx", "node_modules/rendoc/src/mcp/server.ts"],
      "env": {
        "RENDOC_API_KEY": "rd_live_your_key_here"
      }
    }
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests"
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request body",
    "details": { "issues": [...] },
    "doc_url": "https://rendoc.dev/docs/errors#validation-error"
  }
}

{
  "error": {
    "code": "USAGE_LIMIT_EXCEEDED",
    "message": "Monthly document limit reached (100). Upgrade your plan.",
    "details": {
      "current_usage": 100,
      "limit": 100,
      "reset_at": "2026-04-01T00:00:00.000Z"
    },
    "doc_url": "https://rendoc.dev/docs/errors#usage-limit-exceeded"
  }
}

const API_KEY = process.env.RENDOC_API_KEY;
const BASE_URL = "https://rendoc.dev/api/v1";

async function generatePdf(data) {
  const response = await fetch(`${BASE_URL}/documents/generate`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      template_id: "your-template-id",
      data,
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`rendoc error: ${error.error.code} - ${error.error.message}`);
  }

  const { data: doc } = await response.json();
  return doc;
}

async function downloadPdf(documentId, outputPath) {
  const response = await fetch(`${BASE_URL}/documents/${documentId}`, {
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Accept": "application/pdf",
    },
  });

  const buffer = Buffer.from(await response.arrayBuffer());
  const { writeFile } = await import("node:fs/promises");
  await writeFile(outputPath, buffer);
}

// Usage
const doc = await generatePdf({
  company: "Acme Corp",
  items: [{ name: "Widget", price: 49.99 }],
  total: 49.99,
});

console.log("Document ID:", doc.id);
console.log("Download URL:", doc.download_url);

await downloadPdf(doc.id, "output.pdf");

import os
import httpx

API_KEY = os.environ["RENDOC_API_KEY"]
BASE_URL = "https://rendoc.dev/api/v1"


async def generate_pdf(data: dict, template_id: str) -> dict:
    async with httpx.AsyncClient() as client:
        response = await client.post(
            f"{BASE_URL}/documents/generate",
            headers={
                "Authorization": f"Bearer {API_KEY}",
                "Content-Type": "application/json",
            },
            json={
                "template_id": template_id,
                "data": data,
            },
        )
        response.raise_for_status()
        return response.json()["data"]


async def download_pdf(document_id: str, output_path: str) -> None:
    async with httpx.AsyncClient() as client:
        response = await client.get(
            f"{BASE_URL}/documents/{document_id}",
            headers={
                "Authorization": f"Bearer {API_KEY}",
                "Accept": "application/pdf",
            },
        )
        response.raise_for_status()
        with open(output_path, "wb") as f:
            f.write(response.content)


# Usage
import asyncio

async def main():
    doc = await generate_pdf(
        data={
            "company": "Acme Corp",
            "items": [{"name": "Widget", "price": 49.99}],
            "total": 49.99,
        },
        template_id="your-template-id",
    )
    print(f"Document ID: {doc['id']}")
    print(f"Download URL: {doc['download_url']}")

    await download_pdf(doc["id"], "output.pdf")

asyncio.run(main())

curl -X POST https://rendoc.dev/api/v1/documents/generate \
  -H "Authorization: Bearer rd_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "template": {
      "markup": "<h1>Invoice #{{number}}</h1><p>Total: ${{total}}</p>",
      "paper_size": "A4",
      "orientation": "portrait"
    },
    "data": {
      "number": "INV-001",
      "total": "1,250.00"
    },
    "options": {
      "filename": "invoice-001.pdf"
    }
  }'

curl -X POST https://rendoc.dev/api/v1/documents/generate \
  -H "Authorization: Bearer rd_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "your-template-id",
    "data": { "company": "Acme Corp", "total": 1250 }
  }'

curl https://rendoc.dev/api/v1/documents/doc_abc123 \
  -H "Authorization: Bearer rd_live_your_key_here" \
  -H "Accept: application/pdf" \
  -o document.pdf

curl "https://rendoc.dev/api/v1/templates?category=invoice" \
  -H "Authorization: Bearer rd_live_your_key_here"

curl "https://rendoc.dev/api/v1/usage?year=2026&month=3" \
  -H "Authorization: Bearer rd_live_your_key_here"