Endpoints (v1)

1) Create contract

POST /contracts

Uploads a PDF and creates a contract.

multipart/form-data

• file (required) – PDF
• title (required)
• description (optional)

curl -X POST "https://firmato.eu/sign/public/api/v1/contracts" \
  -H "Authorization: Bearer <token>" \
  -F "file=@document.pdf" \
  -F "title=My Document"

---

2) Add signing parties

POST /contracts/{contract_id}/parties

curl -X POST "https://firmato.eu/sign/public/api/v1/contracts/123/parties" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"parties":[{"name":"Alice","email":"alice@example.com"}]}'

Response includes sign_url per signer.

---

3) Send invitations (optional)

POST /contracts/{contract_id}/send

curl -X POST "https://firmato.eu/sign/public/api/v1/contracts/123/send" \
  -H "Authorization: Bearer <token>"

To re-send invitations to all signers: ?force=1.

---

4) Get contract status

GET /contracts/{contract_id}

curl -X GET "https://firmato.eu/sign/public/api/v1/contracts/123" \
  -H "Authorization: Bearer <token>"

---

5) Download original PDF

GET /contracts/{contract_id}/download/original