€17.36 + VAT
Manage the activation and renewal of one or more Legalmail Standard Registered Electronic Mail (REM) boxes via API. Ideal service for individuals and freelancers who do not need to send or receive large quantities of REM messages.
The PEC Service allows you to verify, activate, manage and renew all Legalmail PEC mailboxes. The PEC API can be used to activate PEC mailboxes for your own company or on behalf of third parties, for example to create a website that offers PEC activation services for individuals, professionals and businesses.
The Legalmail Standard PEC mailbox is InfoCert's professional solution for users who do not need to send or receive large volumes of certified email messages. It is particularly suitable for individuals, freelancers and SMEs.
Legalmail Standard includes:
To activate a Legalmail Standard PEC mailbox, the following API requests must be performed.
The first endpoint required to activate a Legalmail Standard mailbox is GET /verifica_pec/{pec}. This endpoint allows you to check the availability of the desired PEC address.
GET /verifica_pec/{pec}
This is an example request to check the availability of the PEC address [email protected]:
GET https://pec.openapi.it/verifica_pec/[email protected]
GET /verifica_pec/{pec}
This is an example response indicating that the address is available (available: true):
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
Once the availability of the PEC address has been verified, you can proceed with registration using the endpoint POST /pec.
POST /pec
This is an example request:
POST https://pec.openapi.it/pec
The request body must include the following information:
This is an example payload:
{
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"tipo_cliente": "PV",
"sottotipo_cliente": "SI",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"cellulare": "3401234567",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "it",
"comune_nascita_richiedente": "roma",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "it",
"provincia_titolare": "rm",
"tipo_documento": "CARTA_D_IDENTITA",
"numero_documento": "CA00000AA",
"data_rilascio_documento": "01/01/2020",
"data_scadenza_documento": "01/01/2030",
"documento_rilasciato_da": "Comune di Roma",
"autorinnovo": false,
"rinnovo_anni": 1,
"spazio_disco": 1024,
"spazio_storico": 1024,
"spazio_conservazione": 512,
"invio_massivo_pec": 50,
"phishing_protection": false,
"password_protection": false,
"multiutenza": [
{
"nome": "luca",
"cognome": "bianchi",
"descrizione": "collaboratore",
"email_gestione_password": "[email protected]"
}
],
"note": "note interne",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"custom": {
"my_order_id": "123456"
}
}
}
In this case, the request concerns a Legalmail Standard PEC mailbox, and the value 'standard' has been passed in the tipo_casella parameter.
Automatic renewal can also be enabled during the request by adding the optional "autorinnovo" parameter to the body with the value 'true' (currently, the default value is 'false').
POST /pec
The response will contain a series of details, including a summary of the PEC mailbox characteristics, its activation status and its ID. The ID will be required for the next activation steps, for checking the mailbox status and for renewal.
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "STANDARD",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"dominio": "legalmail.it",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 0,
"spazio_storico": 0,
"stato": "registrata",
"storico": false,
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
PATCH /pec/{id}/attivazione
To complete the activation, you must download the required forms (GET /pec/{id}/modulo_attivazione) and then submit the correctly completed and signed form, together with the applicant's identity document, through the endpoint PATCH /pec/{id}/attivazione. The ID is the one obtained in the previous response.
PATCH /pec/{id}/attivazione
The response will be as follows:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"dominio": "legalmail.it",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 1024,
"spazio_storico": 1024,
"stato": "in_evasione",
"storico": false,
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
You can check the status of your PEC mailbox at any time using the endpoint GET /pec/{id}.
GET /pec/{id}
The request to check the status of the previously activated PEC with ID 6040e4613a716838dc4eee0e will be:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
GET /pec/{id}
This is an example response:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"dominio": "legalmail.it",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614865504,
"scadenza": 1614868403,
"revoca":
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 1024,
"spazio_storico": 1024,
"stato": "registrata",
"storico": true,
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"data_attivazione": "04/03/2021",
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
Once the activation has been completed, InfoCert will directly send the access credentials for the new PEC mailbox to the applicant.
A Legalmail Standard PEC mailbox can be upgraded at any time through:
Other services also available through the PEC Service include:
The PEC API is used by software houses, banks and financial institutions, accounting portals, Public Administrations and large companies. It allows customers to activate any type of PEC mailbox and manage their communications in a secure and certified manner.
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The API Italian certified e-mail (REM/PEC) allows the activation, management, renewal and extension of the Legalmail Certified Electronic Mail Box space, i.e. InfoCert's tool for sending documents with a high level of security and with the same legal value as a traditional registered letter with return receipt.
Through the API Italian certified e-mail it is also possible to request Certified Email Digital Domicile for communication with private individuals and Public Administration.
The types of Registered Electronic Mail (REM) boxes available are:
All the Registered Electronic Mail (REM) boxes have these features:
The Registered Electronic Mail (REM) can be activated or renewed for one or more years.
In this case the reference endpoint is GET /pec/{id}/rinnovo.
In the renewal request, you will need to pass the ID associated with the registration/activation, which you can obtain via the GET /pec endpoint.
In addition, you can choose the Autorecharge option for an automatic renewal of the box's validity, without having to worry about requesting it manually.
Yes, the Registered Electronic Mail has full legal force and has the same value as a registered letter.
REM (Registered Electronic Mail) messages guarantee:
Yes, all Legalmail Registered Electronic Mail (REM) are already prepared to be updated to the new European standards free of charge.
The Italian Certified E-mail (REM/PEC) API is ideal for software houses, banks and financial institutions, accountancy portals, public administrations and large companies. It allows customers to activate any type of certified e-mail box for secure and certified management of their communications.
The service is provided in 2 hours.
The cost of the service is €11.