€3.90 + VAT
Manage the activation and renewal of one or more Digital Domicile Registered Electronic Mail (REM) mailboxes via API. This service is ideal for individuals who do not need to send or receive large quantities of certified electronic mail messages and want to have the REM mailbox with domiciliodigitale.com as extension.
The Registered Electronic Mail (REM) Service allows you to verify, activate, manage, and renew Digital Domicile mailboxes and all Legalmail REM solutions. The API Registered Electronic Mail (REM) can be used to activate a REM for your company or for third parties, such as for creating a sales site and activating a REM for individuals, professionals, and companies.
The Digital Domicile REM mailbox is the solution for those who do not need to send/receive large quantities of REM messages.
It is particularly suited to individuals and freelancers.
The Digital Domicile Registered Electronic Mail (REM) mailbox includes:
With Openapi, it is possible to certify a custom domain to be used for Domicilio Digitale PEC mailboxes. The request to activate the certified domain can be made directly via API, without having to use external procedures. To start the certification process, the POST /dominio endpoint is available, allowing you to specify the domain to be certified, the provider, the service duration, and the number of associated PEC mailboxes. For some providers, the details of the owner and applicant are also required.
To proceed with the activation of a Digital Domicile Registered Electronic Mail (REM), it is necessary to make the following API requests:
GET/verifica_pec/{pec}
The first useful endpoint for activating Digital Domicile is GET/verifica_pec/{pec}, as this allows you to verify the availability of the desired REM address.
GET/verifica_pec/{pec}
This is an example of a request to check the availability of the REM address [email protected]
GET https://pec.openapi.it/verifica_pec/[email protected]
This is an example of a response indicating that the address is available (available:true):
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
POST/pec
After confirming the availability of the Registered Electronic Mail (REM), you can proceed with the registration through the endpoint POST/pec.
POST/pec
This is a request example:
POST https://pec.openapi.it/pec
The following values must be included in the request body:
During registration, it is also possible to configure certain mailbox options, including the multi-user service and the initial space allocated to the Inbox, Security Archive, and Storage.
This is an example of Payload:
{
"casella_pec": "[email protected]",
"tipo_casella": "DOMICILIODIGITALE",
"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"
},
"spazio_disco": 1024,
"spazio_storico": 1024,
"spazio_conservazione": 0,
"multiutenza": true,
"autorinnovo": true
}
In this case, the request concerns a PEC Domicilio Digitale and the value 'DOMICILIODIGITALE' has been passed in the 'tipo_casella' parameter. The initial storage space for the Inbox and Security Archive, the multi-user service and automatic renewal have also been configured.During the request, automatic renewal can also be activated by adding the optional "autorinnovo" parameter with the value 'true' (currently the default is 'false').
POST/pec
The response will include a summary of the REM characteristics, the activation status, and the ID. The ID will be essential for the next activation steps, checking the status, and renewing.
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "DOMICILIODIGITALE",
"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": "domiciliodigitale.com",
"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 will need to download the required forms (GET/pec/{id}/modulo_attivazione) and submit the correctly filled and signed form, along with the requester's identity document, via the 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": {
"pec_box": "[email protected]",
"box_type": "DOMICILIODIGITALE",
"client_type": "PV",
"client_subtype": "",
"client_subtype_other": "",
"applicant_first_name": "mario",
"applicant_last_name": "rossi",
"email": "[email protected]",
"phone": "0548798569",
"applicant_tax_code": "RSSXXXXXXXX56E",
"applicant_birth_date": "11/04/1982",
"applicant_gender": "M",
"applicant_birth_nation": "IT",
"applicant_birth_province": "RM",
"holder_name": "",
"holder_tax_code_vat": "",
"holder_address": "via verdi 20",
"holder_city": "roma",
"holder_postal_code": "00042",
"holder_country": "IT",
"holder_province": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"domain": "domiciliodigitale.com",
"owner": "[email protected]",
"timestamp": {
"registration": 1614865504,
"last_modification": 1614868403,
},
"mobile": "",
"applicant_birth_city": "",
"activation_code": "10173956",
"uid": "MA177987",
"preservation": false,
"expiration_date": "",
"description": "[email protected]",
"sms": false,
"preservation_space": 0,
"disk_space": 1024,
"historical_space": 1024,
"status": "in_processing",
"historical": false,
"activation_documents": [
"6040e4613a716838dc4eee0e_0_activation.pdf",
"6040e4613a716838dc4eee0e_1_activation.pdf"
],
"id": "6040e4613a716838dc4eee0e",
"auto_renewal": false
},
"success": true,
"message": "",
"error": null
}
GET/pec/{id}
It will be possible to check the status of your REM at any time via the endpoint GET/pec/{id}.
The request to check the status of the previously activated REM with id 6040e4613a716838dc4eee0e will be:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
This is an example of a response:
{
"data": {
"pec_box": "[email protected]",
"box_type": "DOMICILIODIGITALE",
"client_type": "PV",
"client_subtype": "",
"client_subtype_other": "",
"applicant_first_name": "mario",
"applicant_last_name": "rossi",
"email": "[email protected]",
"phone": "0548798569",
"applicant_tax_code": "RSSXXXXXXXX56E",
"applicant_birth_date": "11/04/1982",
"applicant_gender": "M",
"applicant_birth_nation": "IT",
"applicant_birth_province": "RM",
"holder_name": "",
"holder_tax_code_vat": "",
"holder_address": "via verdi 20",
"holder_city": "roma",
"holder_postal_code": "00042",
"holder_country": "IT",
"holder_province": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"domain": "domiciliodigitale.com",
"owner": "[email protected]",
"timestamp": {
"registration": 1614865504,
"last_modification": 1614868403,
"processing": 1614865504,
"expiration": 1614868403,
"revocation": ,
},
"mobile": "",
"applicant_birth_city": "",
"activation_code": "10173956",
"uid": "MA177987",
"preservation": false,
"expiration_date": "",
"description": "[email protected]",
"sms": false,
"preservation_space": 0,
"disk_space": 1024,
"historical_space": 1024,
"status": "registered",
"historical": true,
"activation_documents": [
"6040e4613a716838dc4eee0e_0_activation.pdf",
"6040e4613a716838dc4eee0e_1_activation.pdf"
],
"activation_date": "04/03/2021",
"id": "6040e4613a716838dc4eee0e",
"auto_renewal": false
},
"success": true,
"message": "",
"error": null
}
Upon completion of activation, access details for the new REM box will be sent to the applicant.
The Multi-user service allows multiple users to use the same Domicilio Digitale PEC mailbox. The option can be enabled directly during mailbox registration through the multiutenza parameter or, for existing mailboxes, new users can be added through the endpoint POST/pec/{id}/multiutenza.
For mailboxes managed by InfoCert, the endpoint allows you to add a user to an existing PEC mailbox. For Namirial mailboxes, on the other hand, calling the endpoint enables or disables multi-user mode; in this case, the request body is not considered and must be sent empty.
POST/pec/{id}/multiutenza
This is an example of a request to add a new user to the PEC mailbox:
POST https://pec.openapi.it/pec/6040e4613a716838dc4eee0e/multiutenza
{
"nome": "luca",
"cognome": "bianchi",
"descrizione": "prima utenza",
"email_gestione_password": "[email protected]"
}
POST/pec/{id}/multiutenza
The response contains information about the PEC mailbox and the newly added user:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "BRONZE",
"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"
},
"dominio": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614868312,
"scadenza": 1646391493
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": true,
"data_scadenza": "04/03/2022",
"descrizione": "[email protected]",
"sms": true,
"spazio_conservazione": 512,
"spazio_disco": 3072,
"spazio_storico": 3072,
"stato": "evasa",
"storico": true,
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"data_attivazione": "04/03/2021",
"documenti_conservazione": [
"6040e4613a716838dc4eee0e_0_conservazione.pdf",
"6040e4613a716838dc4eee0e_1_conservazione.pdf"
],
"multiutenza": [
{
"nome": "luca",
"cognome": "bianchi",
"descrizione": "prima utenza",
"email_gestione_password": "[email protected]",
"id_utenza": "6040e4613a716838dc4eee0e_0",
"timestamp": {
"attivazione": 1614868138
},
"userid": "MA177993"
}
],
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
It is possible to retrieve the secondary users associated with a PEC mailbox through the endpoint GET/pec/{id}/multiutenza.
The endpoint returns the secondary users of the multi-user service associated with a PEC mailbox. It applies to InfoCert mailboxes and is not available for Namirial mailboxes (Domicilio Digitale and PEC Massiva), for which the multiutenza parameter is managed as a boolean value.
It is also possible to specify the optional id_subset parameter to retrieve only a specific secondary user.
GET/pec/{id}/multiutenza
To retrieve the users associated with a PEC mailbox, simply specify the mailbox ID:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e/multiutenza
In case of a successful request, the response returns the list of users associated with the mailbox:
{
"data": [
{
"nome": "luca",
"cognome": "bianchi",
"descrizione": "prima utenza",
"email_gestione_password": "[email protected]",
"id_utenza": "6040e4613a716838dc4eee0e_0",
"timestamp": {
"attivazione": 1614868138
},
"userid": "MA177993"
}
],
"success": true,
"message": "",
"error": null
}
This service is already widely used by those who want to resell the Digital Domicile Registered Electronic Mail (REM) activation and renewal service to third parties, for the simple, fast and secure management of their communications (including with the Public Administration).
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 Digital Domicile Registered Electronic Mail (REM) service refers to Openapi’s API REM and allows users to verify, activate, manage, and renew Digital Domicile mailboxes. This service enables the secure sending and receiving of certified email messages to individuals and public administration bodies.
The Digital Domicile REM mailbox is tailored for private individuals, unlike other REM solutions (such as Legalmail Standard, Bronze, Silver, and Gold), which are designed primarily for companies, SMEs, sole traders, and freelancers.
Each REM (Registered Electronic Mail) solution differs in terms of storage capacity and features. The Digital Domicile REM mailbox offers 2 GB of storage (1 GB for inbox space and 1 GB for backup storage).
For the cost of a single registered letter with return receipt, Digital Domicile REM allows unlimited legal communications without any additional costs.
Yes, Digital Domicile REM has full legal validity, equivalent to a registered letter with return receipt (Registered mail A/R). The REM system guarantees:
The Digital Domicile REM service is ideal for those who want to resell the service of activating and renewing Digital Domicile mailboxes to third parties, enabling the management of legal communications (even with public administrations) in a simple, fast, and secure manner.
Yes, it is possible to configure the multi-user service for a PEC Domicilio Digitale mailbox. The option can be activated directly during mailbox registration. For existing mailboxes, it is also possible to manage multi-user access via API. The service allows multiple users to be associated with the same PEC mailbox, according to the configuration provided by the provider.
Yes, it is possible to customize the storage space of the PEC Domicilio Digitale mailbox according to your needs. During registration, you can specify the initial storage space dedicated to the Inbox, Security Archive, and Storage. For existing mailboxes, the storage space can also be modified via API. Storage increases must comply with the values provided by the service and, for Storage, the relevant service must be active.
Yes, with Openapi it is possible to certify a custom domain to be used for PEC Domicilio Digitale mailboxes. The request to activate the certified domain can be made directly via API, specifying the domain and provider. Depending on the provider and the requested configuration, the details of the holder and applicant may also be required.
Yes, it is possible to manage the renewal and various modifications of the mailbox directly via API. Renewal can already be configured during registration through the automatic renewal option. For an existing mailbox, the PATCH /pec/{id} endpoint allows, among other operations, renewal, mailbox upgrades, modification of the available storage space, and management of the multi-user service.
The service is provided within 2 working hours.