Task cost estimation
Estimate HQ Credits for verified PDF files before processing and understand reservation versus actual cost.
Quote a verified task before processing#
Once all verified PDFs have been attached to a waiting task, request a credit estimate. PDFHQ calculates the same estimated billable units used at processing admission (page count for merging, input MiB otherwise), and delegates tariff calculations to the HQTools central catalogue.
curl 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' \
-H 'x-api-key: YOUR_API_KEY'The response contains estimated_hq_credits, estimated_units, price_source=hqtools and estimate_only=true. It does not reserve or deduct credits. When the job executes, the server independently authorizes a new reservation and settles actual consumption.
Cost controls and caveats#
You must attach completed uploads first. This route rejects expired, unready, or other-account documents. Task estimates are not binding: operation output, additional metered units or a tariff change can affect the final charge. Do not assume retries on new tasks are free; retry the same task.
Credit ledger and account pricing