PDFHQ logo

Documents

PDF signatures: visible marks vs eSignature

Understand the boundaries between placing your own handwritten/typed mark, requesting signatures from others, and certificate-backed digital signing.

Server-side API keys Signed storage uploads

Three different PDF signing capabilities#

Visible signing (implemented): use the Sign PDF API to place typed names, dates or user-provided PNG signatures on an authorized document. Output is a new PDF with visible marks, not a cryptographic or identity-verified signature.

Signature requests (sandbox integration implemented): send a document to one or more recipients, explicitly approve sending, track viewed/signed/declined states and retrieve a completed PDF after provider processing. The PDFHQ eSign envelope API uses Dropbox Sign in test mode. Production dispatch and legally binding envelopes are not enabled yet.

Certificate-backed signing (not implemented): signed PDF certificate operations such as PAdES and qualified electronic signatures require trusted certificates and, for qualified signatures, an accredited provider. Visible PDF marks cannot substitute for these guarantees.

Current task request#

Visible signature placement
curl -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"sign"}'

# Upload and confirm each PDF; POST /tasks/TASK_ID/files with its upload_id.
# Then process this task:
curl -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"marks":[{"kind":"typed","page":1,"x0":72,"y0":650,"x1":320,"y1":715,"text":"Jane Doe"}]}}'

Place up to 12 marks on unrotated pages. The API validates geometry, image type and dimensions, returns clear errors and rejects documents with existing digital signatures to avoid inadvertently invalidating them.

PDFHQ logo

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

© 2026 PDFHQ. All rights reserved.