API Changelog

Version 1.0.6

Released on 13/06/2025

The following endpoints have been added:

• GET /v1/repository - List repository files
• GET /v1/repository/{id}/download - Download repository file
• GET /v1/contracts/{id}/supplies/ee - Get electricity supplies for a contract
• GET /v1/contracts/{id}/supplies/gas - Get gas supplies for a contract
• GET /v1/contracts/{id}/supplies/conn - Get internet connection supplies for a contract
• GET /v1/contracts/{id}/supplies/tel - Get telephone supplies for a contract
• GET /v1/contracts/{id}/supplies/eeup - Get EEUP (producing plants) supplies for a contract
• GET /v1/contracts/{id}/supplies/remi - Get REMI supplies for a contract
• GET /v1/contracts/{id}/attachments - List attachments for a contract
• GET /v1/contracts/{id}/attachments/download - Download a specific contract attachment

Version 1.0.5

Released on 24/04/2025

⚠️ Breaking changes: the following endpoints were modified and may affect existing integrations:

• GET /v1/digitalContracts/{id}/attachments/{type}/download - Download a specific attachment by type
• GET /v1/digitalContracts/{id}/attachments/download - Download all attachments as a ZIP
• GET /v1/digitalContracts/{id}/details/power - Get power details for a digital contract
• GET /v1/digitalContracts/{id}/details/gas - Get gas details for a digital contract
• GET /v1/invoices/{id}/attachments/download - Download a specific invoice attachment
• GET /v1/digitalContracts/{id}/document/downloadSigned - Download the signed PDF of the contract
• GET /v1/digitalContracts/{id}/document/downloadUnsigned - Download the unsigned PDF of the contract
• POST /v1/digitalContracts/{id}/document - Generate the PDF version of the contract
• POST /v1/digitalContracts/{id}/document/smartSign - Start the digital signing process for the contract

Added the following new endpoints:

• GET /v1/geo/countries - Get list of countries
• GET /v1/geo/provinces - Get list of provinces (Italy only)
• GET /v1/geo/cities - Get paginated list of cities with filters
• GET /v1/geo/toponyms - Get list of geographical toponym classes by country

Version 1.0.4

Released on 17/04/2025

Added the following endpoints:

• GET /v1/digitalContracts/{id}/generate-contract - Generate the final contract PDF
• GET /v1/digitalContracts/{id}/sign-contract - Start the contract signing process
• GET /v1/digitalContracts/{id}/download-contract-signed - Download the signed contract PDF

Version 1.0.3

Released on 11/04/2025

Added the following endpoints:

• GET /v1/digitalContracts/{id}/attachments - List attachments for a digital contract
• POST /v1/digitalContracts/{id}/attachments/download - Download a specific attachment for a digital contract
• GET /v1/digitalContracts/{id}/attachments/downloadZip - Download all attachments as a ZIP for a digital contract
• GET /v1/digitalContracts/{id}/download-pdf-unsigned - Download the unsigned PDF for a digital contract
• GET /v1/invoices/{id}/attachments - List attachments for an invoice
• POST /v1/invoices/{id}/attachments/download - Download a specific attachment for an invoice

Version 1.0.2

Released on 04/04/2025

Added the following endpoints:

• GET /v1/invoices/{id} - Get invoice by ID
• GET /v1/invoices - List invoices
• GET /v1/contracts/{id} - Get contract by ID
• GET /v1/contracts - List contracts

Version 1.0.1

Released on 04/01/2025

Added the following endpoints:

• GET /v1/digitalContracts/{digitalContractId} - Get digital contract by ID
• GET /v1/digitalContracts/{digitalContractId}/powerDetails - Get power details for a digital contract
• GET /v1/digitalContracts/{digitalContractId}/gasDetails - Get gas details for a digital contract
• GET /v1/digitalContracts - List digital contracts

Version 1.0.0

Released on 25/03/2025

Added the following endpoints:

• POST /v1/auth/login - Authenticate a user and generate a JWT
• POST /v1/digitalContracts/{id}/attachments - Upload one or more attachments for a digital contract
• POST /v1/digitalContracts - Create a new digital contract
• POST /v1/digitalContracts/{id}/gasDetails - Insert gas details for a digital contract
• POST /v1/digitalContracts/{id}/powerDetails - Insert power details for a digital contract

Resources

Download the Postman collection and environment: