External Signing API (v1)
This documentation is for third-party applications that need to submit PDFs and complete a signing workflow using firmato.eu.
Base URLs
API base
https://firmato.eu/sign/public/api/v1/
Recipient signing UI
https://firmato.eu/sign/public/sign.php?token=...
Final stamped download
https://firmato.eu/sign/public/signed_download.php?token=...
High-level flow
- Obtain an access token (OAuth2 client_credentials).
- Create a contract by uploading a PDF.
- Add one or more signing parties.
- Send invitations (optional) or distribute signing URLs in your UX.
- Poll contract status.
- Download the final stamped PDF once fully signed.
Security model
- HTTPS required.
- Tokens are short-lived; store secrets server-side only.
- Do not expose
client_secret in browsers or mobile apps.
