Certified Message Massive Delivery API Service
From: €0.002 + VAT
Send large quantities of Certified Electronic Mail messages to your contacts via API, in full compliance with regulations.
Certified Message Massive Delivery API Service is the perfect solution for those who need to manage a large number of legal value communications and want to integrate the service directly into their platform, management or CRM via API. It does not require the activation of any software and allows certified messages to be sent, securely and according to AGID regulations, in bulk and directly via API.
It is often used in conjunction with the REM-Company API service, which allows Certified Emails from any Italian company to be obtained in real time.
Certified Message Massive Delivery API Service has an annual fee of €99 and a cost of €0,05 per individual message. With subscription solutions, it is possible to send up to 1.2 million certified messages per year, starting from €0,002.
The email extension is @pecmassiva.com, but it is also possible—upon request—to customize the domain, using, for example, your company’s name.
Verify certified email message address
To check the availability of a certified email message address, the following endpoint GET/verifica_pec/{pec} can be used by passing the desired certified email message address as a parameter.
EXAMPLE REQUEST
GET/verifica_pec/{pec}This is an example of a request to check the availability of a certified email address [email protected]
GET https://pec.openapi.it/verifica_pec/[email protected]EXAMPLE RESPONSE
GET/verifica_pec/{pec}This is an example of a response indicating that the address is available (avalaible:true):
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}Register Massive Delivery API Service
EXAMPLE REQUEST
POST/pecOnce the availability of the certified email message has been ascertained, registration can be carried out via the endpoint POST/pec where the body of the request will include the following values:
- name of the mailbox
- customer type (e.g. PV for private individual)
- applicant's personal data (Name and Surname or Denomination, applicant's tax code or VAT number, date and place of birth, address of residence or registered office)
This is an example of a payload with all the data to be passed on:
{
"casella_pec": "[email protected]",
"tipo_casella": "PECMASSIVA",
"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"
}
}During the application phase, it is also possible to activate automatic renewal by adding the optional parameter "autorinnovo" to the body with value 'true' (it is currently ‘false’ by default).
EXAMPLE RESPONSE
POST/pecThe response will contain a range of information including a summary of the characteristics of the REM, the activation status and the ID. The ID will be crucial for the next activation steps, to check the status and in the future to proceed with renewal.
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "PECMASSIVA",
"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": "postamassiva.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
}Activate Delivery API Service
EXAMPLE REQUEST
PATCH/pec/{id}/attivazioneIn order to complete the activation it will be necessary to download the required form (GET/pec/{id}/modulo_attivazione) and proceed to send the form, correctly filled in and signed, as well as the applicant's ID via the endpoint PATCH/pec/{id}/attivazione.The id is the one obtained in the previous response.
EXAMPLE RESPONSE
PATCH/pec/{id}/attivazioneThe response will be as follows:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "PECMASSIVA",
"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": "postamassiva.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": 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
}Check status Delivery API Service
EXAMPLE REQUEST
GET/pec/{id}It will be possible to check the status of the registered REM at any time via the endpoint GET/pec/{id}. The request to check the status of the previous certified email message activated with 6040e4613a716838dc4eee0e will be:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0eEXAMPLE RESPONSE
GET/pec/{id}This is an example of a response where the box is in registered status:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "PECMASSIVA",
"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": "postamassiva.com",
"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
}PLEASE NOTE: Currently, verification is only possible for customers who have activated Certified Message Massive Delivery API Service via the API and not via www.pecmassiva.com.
While the API REM/PEC (https://pec.openapi.it) must be used to register and activate Certified Message Massive Delivery API service, the management of REM/PEC, such as sending messages and verifying sendings, is entrusted to another API specifying Certified Message Massive Delivery API service (https://ws.pecmassiva.com).
Send certified messages
Certified Message Massive delivery API service can be used to send certified email messages to one or more recipients with the addition of attachments.
EXAMPLE REQUEST
POST/sendThis in an example of request:
{
"sender": "[email protected]",
"recipient": "[email protected]",
"subject": "Invio di prova pec massiva",
"body": "Salve, questa rappresenta una prova di invio, che prevede un corpo in html",
"attachments": [
{
"name": "allegato1.png",
"file": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAAAGX="
}
],
"username": "your_pec_username",
"password": "your_pec_password"
}
In the case of several recipients, this will be an array of recipients.
EXAMPLE RESPONSE
POST/sendThe sending response is a sending identification code that can be used to return confirmation of receipt and delivery email information.
{
"success": true,
"sent": 1,
"message": "",
"message_id": "2020082610003492"
}
List acquisition of sent messages
GET/inboxThrough the GET/inbox it is possible to obtain the list of all emails in the inbox.
{
"data":[
{
"sender": "[email protected]",
"recipient": "[email protected]",
"date": "Wed, 26 Aug 2020 10:00:35 +0200",
"object": "ACCETTAZIONE: Invio di prova pec massiva 2020082610003492",
"id": 1
},
{
"sender": "\"Per conto di: [email protected]\" ",
"recipient": "[email protected]",
"date": "Wed, 26 Aug 2020 10:00:35 +0200",
"object": "POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492",
"id": 2
},
{
"sender": "[email protected]",
"recipient": "[email protected]",
"date": "Wed, 26 Aug 2020 10:00:36 +0200",
"object": "CONSEGNA: Invio di prova pec massiva 2020082610003492",
"id": 3
},
],
"success": true,
"message": "",
"total": 981,
"page": 39,
"n_of_pages": 39
}
Verify certified messages usage
EXAMPLE REQUEST
GET/quota/{mailbox}At any time you can check the REM utilisation quota and limit via GET/quota/{mailbox}. The parameters required to make the request are: username and password.
EXAMPLE RESPONSE
GET/quota/{mailbox}The response will indicate the usage (usage) and the total size (limit) of the Inbox. The data is expressed in megabytes.
{
"data": {
"usage": 171012,
"limit": 1048576
},
"success": true,
"message": "",
}The Certified Message Massive Delivery API service is used by decide of companies, public and private, from completely different sectors (e.g. Energy, Credit Recovery, Environmental Services, Marketing, Consortia, Payment Institutions, Tender and Procurement Offices, Industries), which need to manage a large volume of legally valid and traceable communications (e.g. official documents and contracts).
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!
Certified Message Massive Delivery service allows you to send - via API - legally valid REM messages (with any attachments), in a massive and secure manner.
It does not require the activation of any software and allows a large number of communications to be managed in accordance with AGID regulations, at a very competitive cost and with the possibility to request an annual subscription, in order to save on individual sendings.
Yes, the Certified Message Massive Delivery service has @pecmassiva.com as its starting extension, but - on request - it is also possible to customise the domain name, e.g. by choosing your own company name.
Yes, the Certified Message Massive Delivery API service allows you to attach files and documents before sending.
Yes, it has full legal validity (in compliance with AGID regulations) and holds the same legal weight as a registered letter with acknowledgment of receipt. This makes it an effective and secure tool for official communications, such as notifications, contracts, or formal business correspondence.
Messages sent through your Certified Email mailbox guarantee:
- Delivery certainty: Confirmation of the sending and receipt of the message is provided
- Content integrity: It ensures that the content has not been altered during transmission
- Timestamp validity: The date and time of when the message was sent and received are certified
Certified Message Massive Delivery API Service is designed for companies and organizations that need to manage a high volume of legally valid and traceable communications, such as official documents and contracts. API integration is an ideal solution in these cases, as the process is automatic, fast, and efficient. By eliminating manual intervention, the risk of errors is minimized.
The service is delivered within 24 hours.
Carbon free energy for Our Cloud 
Low CO2
© 2024 Openapi SpA, a single-member company, under the direction and control of Open Holding Srl.
Viale Filippo Tommaso Marinetti 221 - 00143 Rome - Business Register: 1378273, Share Capital: €50,000.00, VAT Number: IT12485671007, Recipient Code: 'USAL8PV' - Certified Email: 
Openapi is certified in: Quality System - **UNI EN ISO 9001:2015** - Data Quality **ISO 25012:2014** - Security Management **ISO/IEC 27001:2022**
All prices are net of any VAT, stamp duty, registration fees, or other taxes that may be due. All logos listed on the portal are copyrighted and owned by their respective owners.
