rendoc

Official Python SDK for the rendoc PDF generation API.

• Sync and async clients
• Full type hints
• Python 3.9+

Installation

pip install rendoc

Quick start

Sync

from rendoc import Rendoc

client = Rendoc(api_key="rnd_...")

# Generate a PDF from markup
doc = client.documents.generate(
    markup="<h1>{{title}}</h1>",
    data={"title": "Hello World"},
    paper_size="A4",
)
print(doc.download_url)

# Generate from a template
doc = client.documents.generate(template_id="tmpl_123", data={"name": "John"})

# List templates
templates = client.templates.list()
invoices = client.templates.list(category="INVOICE")

# Check usage
usage = client.usage.get()
print(f"{usage.usage.documents}/{usage.usage.limit} documents used")

Async

import asyncio
from rendoc import AsyncRendoc

async def main():
    client = AsyncRendoc(api_key="rnd_...")
    doc = await client.documents.generate(
        markup="<h1>Hi</h1>",
        data={},
    )
    print(doc.download_url)
    await client.close()

asyncio.run(main())

Context manager

# Sync
with Rendoc(api_key="rnd_...") as client:
    doc = client.documents.generate(markup="<h1>Hi</h1>", data={})

# Async
async with AsyncRendoc(api_key="rnd_...") as client:
    doc = await client.documents.generate(markup="<h1>Hi</h1>", data={})

Error handling

from rendoc import Rendoc, AuthenticationError, RateLimitError, RendocError

client = Rendoc(api_key="rnd_...")

try:
    doc = client.documents.generate(markup="<h1>Hi</h1>", data={})
except AuthenticationError:
    print("Invalid API key")
except RateLimitError:
    print("Too many requests — slow down")
except RendocError as e:
    print(f"API error: {e.message} (status {e.status_code})")

Custom base URL

client = Rendoc(api_key="rnd_...", base_url="https://custom.rendoc.dev")

Documentation

Full API reference at https://rendoc.dev/docs.