Italian certified e-mail

You can check whether a domain is certified, i.e., eligible for sending and receiving Certified Emails, via the GET /domini_pec/{dominio} endpoint.

Before proceeding with any activation request, it is necessary to verify the availability of a PEC address using the method: GET /verifica_pec/{pec}.

To make a request to the GET /domini_pec/{dominio} endpoint you need to pass in the body of the request as the value the domain of the PEC.

You can check the full list of registered CEMs via the same Openapi account with the GET /pec endpoint.

To make a request to the GET /verifica_pec/{pec} dominio and thus verify the availability of a Certified Email address, it is necessary to pass in the body of the request as the value the full address of the Certified Email, for example: [email protected].

Currently it is only possible to check the availability of Legalmail and Domicilio Digitale CEMs.

You can register the following types of Certified Email boxes:

• 'box_name'@legalmail.it (Ex. [email protected]) for STANDARD, BRONZE, SILVER AND GOLD boxes;
• 'box_name'@domiciliodigitale.com (Ex. [email protected]) for the DOMICILIODIGITALe box;
• 'box_name'@pecmassiva.com (Ex. [email protected]) for the PECMASSIVA box.

No parameter or value is needed in the body of the request.

The response to the request will indicate information such as CEM address, box type, status, expiration date, registration.

You can proceed to register a Certified Email address via the POST /pec endpoint.

Remember that registration does not automatically provide for activation of the Certified Email box, which must be completed by sending the necessary documentation via the PATCH endpoint /pec/{id}/activation. The id is present in the response to the POST /pec request.

To complete the activation of a Certified Email (CEM/PEC), it is necessary to send via the PATCH method /pec/{id}/activation:

• valid ID document
• completed and signed activation form

For DOMICILIODIGITALE and PECMASSIVA boxes, it is necessary to create a single document consisting of the signed activation form and the ID document.

The documents must be in PDF format.

The activation form is available using the GET/pec/{id}/modulo_attivazione method.

The activation form is available using the GET/pec/{id}/modulo_attivazione method.

The id is present in the POST request response /pec .

The status of a Certified Email box can be:

• registrata (registered)
• in_attivazione (in_activation)
• evasa (evaded)
• revocata (revoked)
• chiusa (closed)

The status 'registrata' ('registered') means that the CEM/PEC address has been registered via the POST /pec endpoint but the necessary documentation (documents and completed and signed activation form) must be sent to activate the box. To send the documentation, the GET/pec/{id}/modulo_attivazione method must be used. Upon completion of the request the status will change to 'in_attivazione' (in_activation').

Once the documentation has been sent, it will be verified and in a few hours the status of the CEC will change to 'processed' and the box will be usable.

It is possible at any time to check the status of a CEM via the GET method /pec/{id}.

The status 'revocata ('revoked') can mean that the CEM address has not been renewed or that revocation has been requested via the dedicated method (DELETE /pec/{id}).

Yes, it is possible to change the characteristics of the Certified Electronic Mail, currently only for Legalmail boxes.

You can specifically

• increase inbox size (PATCH method /pec/{id}/modifica)
• increase security archive size (PATCH /pec/{id}/modifica)
• enable preservation (PATCH /pec/{id}/conservazione)
• upgrade between two box types, e.g. from bronze to silver (PATCH /pec/{id}/trasformazione)

It is possible to renew a PEC for one or more years via the GET endpoint /pec/{id}/rinnovo.

In the renewal request, it will be necessary to pass the ID associated with the registration/activation.

Via the GET endpoint /pec you can obtain the data, including the ID, of all activated CEMs (Certified Electronic Mails).