API Documentation
Integrate GetStampped into your applications
Getting Started
The GetStampped API allows you to programmatically add stamps and signatures to PDF documents. Build powerful document automation workflows.
POST https://api.getstampped.online/v1/documents/stamp
Authentication
All API requests require an API key. Include it in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Request Example
curl -X POST https://api.getstampped.online/v1/documents/stamp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"pdf_url": "https://example.com/document.pdf",
"stamp_config": {
"type": "circle",
"text": "APPROVED",
"color": "#ef4444",
"page": 1,
"x": 100,
"y": 100
}
}'Response Example
{
"id": "doc_123456",
"status": "success",
"document_url": "https://getstampped.online/documents/doc_123456.pdf",
"expires_at": "2025-01-20T12:00:00Z"
}POST /v1/documents/stamp
Add a stamp to a PDF document
# Request body
pdf_url: string (required)
stamp_config: object (required)
- type: "circle" | "rectangle" | "oval" | "badge"
- text: string
- color: hex color
- page: number
- x: number (pixels)
- y: number (pixels)
POST /v1/documents/sign
Add a signature to a PDF document
# Request body
pdf_url: string (required)
signature_url: string (required)
page: number (required)
x: number (pixels)
y: number (pixels)
GET /v1/documents/id
Retrieve document status and download URL
Rate Limits
Free Plan
3 requests/day
Premium Plan
10,000 requests/month