> ## Documentation Index
> Fetch the complete documentation index at: https://docs.curatepdf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete reference for the CuratePDF API

## Welcome to the CuratePDF API

The CuratePDF API is a comprehensive PDF generation service that allows you to create, manage, and generate PDF documents from templates with dynamic data binding. Our API provides powerful template management with secure file storage.

## Key Features

<CardGroup cols={2}>
  <Card title="PDF Generation" icon="file-pdf" href="/api-reference/endpoint/generate-pdf">
    Generate PDFs from templates with dynamic data binding and secure cloud storage
  </Card>

  <Card title="Template Management" icon="file-pen" href="/api-reference/endpoint/templates">
    Full CRUD operations for managing PDF templates with validation and versioning
  </Card>

  <Card title="File Storage" icon="folder" href="/api-reference/endpoint/file-storage">
    Secure cloud storage for generated PDFs with time-limited download URLs
  </Card>

  <Card title="Template Preview" icon="eye" href="/api-reference/endpoint/template-preview">
    Preview templates as images and validate template structures
  </Card>
</CardGroup>

## Quick Start

### 1. Get Your API Key

First, create an API key in the [Developer Portal](https://app.curatepdf.com/developer):

### 2. Create a Template

Use CuratePDF's drag and drop editor to create a pdf template.

### 3. Generate a PDF

```bash theme={null}
curl -X POST "https://api.curatepdf.com/api/generate-pdf" \
  -H "X-API-Key: dk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "template_123456789",
    "data": {
      "invoiceNumber": "INV-2024-001",
      "customerName": "John Doe",
      "amount": 1250.00
    },
    "filename": "invoice_2024_001.pdf"
  }'
```

## Base URL

All API requests should be made to:

```
https://api.curatepdf.com
```

## Rate Limiting

API endpoints have different rate limits based on their computational requirements:

| Endpoint Type       | Rate Limit   | Time Window |
| ------------------- | ------------ | ----------- |
| Template Management | 100 requests | 1 minute    |
| PDF Generation      | 10 requests  | 1 minute    |

## Use Cases

### Invoice Generation

Generate professional invoices with dynamic customer data, line items, and branding.

### Report Creation

Create data-driven reports with charts, tables, and formatted content.

### Certificate Generation

Batch generate certificates, diplomas, or achievement documents.

### Contract Automation

Generate contracts and legal documents with variable terms and conditions.

### Marketing Materials

Create personalized marketing materials, proposals, and presentations.

## Ready to get started? [Create your API key](https://app.curatepdf.com/developer) and begin building with the CuratePDF API!
