API Endpoints
PDFBolt has three conversion endpoints (Direct, Sync, Async), one usage endpoint for checking your plan and remaining conversions, and Template API endpoints for managing reusable templates.
For an interactive view of endpoints, schemas, error responses, and webhook payloads, see the OpenAPI Reference.
Base URL
All API requests are made to:
https://api.pdfbolt.com
Authentication
API Key
Use a conversion API key in the API-KEY header for /v1/direct, /v1/sync, /v1/async, and /v1/usage requests.
API-KEY: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Find your conversion API key on the API Credentials page in your Dashboard. You can manage up to 5 conversion API keys.
Personal Access Token
Protected Template API requests require a Personal Access Token in the PERSONAL-ACCESS-TOKEN header.
PERSONAL-ACCESS-TOKEN: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Create Personal Access Tokens on the Dashboard API Credentials page.
GET /v1/templates/contract is public and does not require authentication.
Quick Example
Convert a webpage to PDF and save it as webpage.pdf:
curl 'https://api.pdfbolt.com/v1/direct' \
-H 'API-KEY: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{"url": "https://example.com"}' \
-o webpage.pdf
This example converts a URL. You can also use HTML or a template ID with data – see source parameters for all input options.
Endpoints Overview
| Endpoint | Description | Method | Response | Documentation |
|---|---|---|---|---|
/v1/direct | Generates PDFs from URLs, HTML, or templates and returns them in the response. | POST | Raw PDF or Base64-encoded PDF in the HTTP response body. | Direct Parameters Common Parameters |
/v1/sync | Generates PDFs from URLs, HTML, or templates and provides a downloadable URL. | POST | JSON containing a downloadable URL to the generated PDF. | Sync Parameters Common Parameters |
/v1/async | Processes URLs, HTML, or templates and sends results via webhook. | POST | JSON with requestId, plus webhook callback when generation completes. | Async Parameters Common Parameters |
/v1/usage | Returns the current plan, recurring and one-time conversion packages, and remaining conversions. | GET | JSON with plan, recurring, and oneTime conversion details. | Usage Response |
/v1/templates/* | Lists, validates, previews, compares, saves, and publishes reusable templates. | GET / POST | JSON or raw PDF, depending on operation. | Template API |
Response Headers
PDFBolt returns headers that help you track conversion cost, monitor rate limits, and verify async webhooks. Conversion API requests and Template API preview and diff requests that pass the conversion rate limiter include the rate-limit headers listed below. /v1/usage and successful Template API management responses do not include them. Template API management responses with HTTP 429 include Retry-After.
| Header | Applies to | Description |
|---|---|---|
x-pdfbolt-conversion-cost | /v1/direct, /v1/sync, Template API preview/diff, and async webhook callbacks | Document credits charged for the request. |
Content-Disposition | Successful /v1/direct responses | Controls inline vs attachment delivery. Includes filename when provided. |
x-pdfbolt-signature | Async webhook callbacks | HMAC-SHA256 signature of the raw request body, prefixed sha256=. |
x-pdfbolt-limit-minute | Conversion API and Template API preview/diff | Request limit for the current rolling minute. |
x-pdfbolt-remaining-minute | Conversion API and Template API preview/diff | Requests remaining in the current rolling minute. |
x-pdfbolt-limit-hour | Conversion API and Template API preview/diff | Request limit for the current rolling hour. |
x-pdfbolt-remaining-hour | Conversion API and Template API preview/diff | Requests remaining in the current rolling hour. |
x-pdfbolt-limit-day | Conversion API and Template API preview/diff | Request limit for the current rolling 24‑hour window. |
x-pdfbolt-remaining-day | Conversion API and Template API preview/diff | Requests remaining in the current rolling 24‑hour window. |
Retry-After | Template API management responses with HTTP 429 | Number of seconds to wait before retrying the request. |
See Rate Limits for request limits and concurrency rules.
Endpoint Documentation
Read the detailed documentation for each endpoint:
📄️ Direct Conversion
📄️ Sync Conversion
📄️ Async Conversion
📄️ Usage Monitoring
📄️ Template API
📄️ OpenAPI Reference
Related Topics
- Error Handling – HTTP status codes, error response format, and recommended actions.
- Rate Limits – Per-plan request limits, concurrency rules, and 429 handling.
- IP Addresses – Static outbound IPs to add to your firewall allowlist.
- Conversion Parameters – Full reference for all PDF generation options.