External Signing API (v1)

This documentation is intended for third-party applications that need to submit PDF documents and complete a signing workflow using firmato.eu.

---

Base URLs

API base:
https://firmato.eu/sign/public/api/v1/

Signing UI (recipients):
https://firmato.eu/sign/public/sign.php?token=...

Final stamped download (once fully signed):
https://firmato.eu/sign/public/signed_download.php?token=...

---

High-level flow

1. Obtain an access token (OAuth2 client_credentials).
2. Create a contract by uploading a PDF.
3. Add one or more signing parties (name/email).
4. Send invitations (firmato.eu emails recipients the signing link).
5. Poll contract status or store sign URLs; when fully signed, download final stamped PDF.

The API writes to the existing firmato.eu database tables and uses the built-in signing endpoints already present in the platform.