PDF Compression
Reduce PDF size with compress-pdf (high, balanced, or strong)
Automate File Processing with Flimpa API
Compress PDFs, optimize images and build file-processing workflows with a simple async REST API
- Free during Early Access
- No credit card required
- Async task processing
- Anonymous testing available
create-task.tstypescript
const form = new FormData();form.append("file", pdfFile);form.append("operation", "compress-pdf");form.append("compressionMode", "balanced"); const create = await fetch("https://api.flimpa.com/api/v1/tasks", { method: "POST", headers: { "X-API-Key": apiKey }, body: form,}); const { taskId, accessToken, pollUrl } = await create.json();Supported operations
PDF Conversion
Convert PDFs with convert-pdf, or create PDFs with convert-to-pdf
Image Compression
Optimize images with compress-image for JPEG, PNG and WebP
Image Conversion
Convert images with convert-image, including WebP workflows
More planned
OCR, AI processing and presentation APIs are not available yet
How it works
- 1
Upload a file
POST multipart form data with operation and file to /api/v1/tasks
- 2
Receive task credentials
Get taskId, pollUrl and accessToken in the create response (HTTP 202)
- 3
Track progress
GET the task with X-Task-Access-Token until status is COMPLETED or FAILED
- 4
Download the result
Use resultUrl from the status payload, or the download endpoint with the same token
Create response (HTTP 202)
202 Acceptedjson
{ "taskId": "f9f7d3c0-6e3a-4fd8-9c1a-2b8e7a4d1f20", "status": "PENDING", "pollUrl": "/api/v1/tasks/f9f7d3c0-6e3a-4fd8-9c1a-2b8e7a4d1f20", "accessToken": "1735689600000.a1b2c3d4e5f6..."}Why asynchronous?
File jobs can take seconds to minutes. The API accepts the upload, queues the work, and lets you poll status instead of holding an open HTTP connection
Integrate in minutes
Create a task, then poll with X-Task-Access-Token from the create response. API key is optional for light anonymous use
create-task.shbash
curl -X POST https://api.flimpa.com/api/v1/tasks \ -H "X-API-Key: YOUR_API_KEY" \ -F "file=@document.pdf" \ -F "operation=compress-pdf" \ -F "compressionMode=balanced" # Poll status (accessToken from create response)curl -X GET https://api.flimpa.com/api/v1/tasks/TASK_ID \ -H "X-Task-Access-Token: YOUR_ACCESS_TOKEN"API usage limits
Start anonymously, then unlock higher limits with a free developer account and API key
| Feature | Anonymous access | Free developer account |
|---|---|---|
| Registration Required | No | Yes |
| API Key | Not available | Included |
| Requests per Hour | 20 | 100 |
| Requests per Day | 100 | 500 |
| Maximum File Size | 5 MB | 20 MB |
| Concurrent Tasks | 1 | 3 |
| Task History | No | Available |
| Usage Dashboard | No | Available |
Flimpa API is free of charge during the Early Access period. Limits may change later for platform stability
Ready to build?
Create a free account to get an API key, or start anonymously within the published limits