LogoDOCS
OverviewAuthenticationRate LimitsErrors
Logo
Sign in →

API Documentation

The PDFGate API provides a set of HTTP endpoints for working with PDF documents, with a focus on digital signatures. You can sign documents and manage document workflows, along with generating PDFs from HTML or URLs and processing existing files.

All requests are authenticated using an API key and return JSON responses using standard HTTP status codes.

PDFGate offers a sandbox environment for testing your integration without affecting production data. The environment is determined by the request URL, and your API key must match the selected environment.

Each request operates on a single document or resource.

Authentication

All API requests must be authenticated using an API key. Authentication is handled via the Authorization header in your HTTP requests.

To get started, log in to your PDFGate account and create an API key from the Settings page in the dashboard. Ensure the key is active before using it in your code.

NODE.JS
CURL
PYTHON
GO
PHP
JAVA
C#
RUBY
1const response = await fetch("https://api.pdfgate.com/...", {2  headers: {3    Authorization: "Bearer YOUR_API_KEY",4  },5});

PDFGate supports two types of API keys:

API KEYS
Production:live_xxxxxxxxxxxxxxx
Sandbox:test_xxxxxxxxxxxxxxx

Use sandbox keys for testing purposes and production keys in your live environment.

Rate limits

The PDFGate API uses different rate limits for each account type in the production environment. In the sandbox environment, the rate limits are the same for all account types.

Rate limits
EndpointProductionSandbox
POST/v1/generate/pdf
POST/forms/flatten
POST/forms/extract-data
POST/forms/fields
POST/watermark/pdf
POST/protect/pdf
POST/compress/pdf
POST/envelope
POST/envelope/:id/send
POST/upload
POST/webhook
Per account type requests:
  • Personal: 3
  • Starter: 3
  • Basic: 5
  • Professional: 10
  • Professional Plus: 20
Per account type requests:
  • Personal: 2
  • Starter: 2
  • Basic: 2
  • Professional: 2
  • Professional Plus: 2
GET/document/:id
DELETE/document/:id
GET/file/:id
GET/envelope/:id
GET/webhook/:id
DELETE/webhook/:id
Per account type requests:
  • Personal: 40
  • Starter: 50
  • Basic: 100
  • Professional: 150
  • Professional Plus: 200
30 concurrent requests

Errors

The PDFGate API uses standard HTTP status codes to indicate whether a request was successful or failed. Error responses include a message and additional details to help identify and resolve the issue.

If a request fails, review the response body for error information and ensure your request parameters, authentication, and API usage are correct.

Error Code
CodeError
400Bad request
401Unauthorized
404Not found
422Unprocessable entity
429Too many requests
500Internal server error