PDFHQ logo

Documents

DocumentationGetting started

Task cost estimation

Estimate HQ Credits for verified PDF files before processing and understand reservation versus actual cost.

Server-side API keys Signed storage uploads

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
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
PDFHQ logo

PDF tools and document intelligence. Prepare, understand and work with your documents.

© 2026 PDFHQ. All rights reserved.