HomeProductsCertified Message Massive Delivery API Service Flat

Certified Message Massive Delivery API Service Flat

FREE 1440 requests/day

€0.05 + VAT

FREE requests

Send up to 30.000 Registered Electronic Mail (REM/PEC) messages per month and up to 100 MB per message, with the possibility of attaching files and customising the extension. Everything via API.

Delivery

In 24 hours

available for
  • eu

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 Flat, unlike the Standard solution, includes the customised domain and no cost per sending.

With this solution you can send up to 30.000 certified messages per month, 100 MB per message and attach files. In contrast to the Standard solution, Flat includes the customised domain and no cost per sending. There is only a payment for the annual fee, which is €1.500 on offer instead of €3.000.

Currently, activation of the Certified Message Massive Delivery API Service Flat is fully managed via www.pecmassiva.com.

Once activation is complete, it will be possible to send messages, access the sending history, and check consumption directly via the API.

Below we see the individual endpoints in detail; the first 4 (address verification, registration, activation and REM status verification) refer to the API REM, while the last 3 (sending, message access, usage verification) refer to the Certified Message Massive Delivery API Service.

Verify certified email message address

To check the availability of a certified email message address, the following endpoint GETpec.openapi.it/verifica_pec/{pec} can be used by passing the desired certified email message address as a parameter.

EXAMPLE REQUEST

GET/verifica_pec

This is an example of a request to check the availability of a certified email address impresa@pecmassiva.com

https://pec.openapi.it/verifica_pec/impresa%40pecmassiva.com

EXAMPLE RESPONSE

GET/verifica_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 Flat

EXAMPLE REQUEST

POST/pec.openapi.it/pec

Once the availability of the certified email message has been ascertained, registration can be carried out via the endpoint POST/pec.openapi.it/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": "yourpec@pecmassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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/pec.openapi.it/pec

The 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": "yourpec@postamassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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": "mail@domain.com",
    "timestamp": {
      "registrazione": 1614865504,
      "ultima_modifica": 1614868403,
    },
    "cellulare": "",
    "comune_nascita_richiedente": "",
    "cod_attivazione": "10173956",
    "uid": "MA177987",
    "conservazione": false,
    "data_scadenza": "",
    "descrizione": "yourpec@postamassiva.com",
    "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 Flat

EXAMPLE REQUEST

PATCH/pec/{id}/attivazione

In 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}/attivazione

The response will be as follows:

{
  "data": {
    "casella_pec": "yourpec@pecamassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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": "mail@domain.com",
    "timestamp": {
      "registrazione": 1614865504,
      "ultima_modifica": 1614868403,
    },
    "cellulare": "",
    "comune_nascita_richiedente": "",


    "cod_attivazione": "10173956",
    "uid": "MA177987",
    "conservazione": false,
    "data_scadenza": "",
    "descrizione": "yourpec@testcert.legalmail.it",
    "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 Flat

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:

https://pec.openapi.it/pec/6040e4613a716838dc4eee0e

EXAMPLE RESPONSE

GET/pec/{id}

This is an example of a response where the box is in registered status:

{
  "data": {
    "casella_pec": "yourpec@pecmassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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": "mail@domain.com",
    "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": "yourpec@pecmassiva.com",
    "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
}

Send certified messages

Delivery API Service Flat can be used to send certified email messages to one or more recipients with the addition of attachments.

EXAMPLE REQUEST

POST/send

This in an example of request:

{
  "sender": "dev-api@pecmassiva.com",
  "recipient": "dev-api@pecmassiva.com",
  "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/send

The 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

EXAMPLE REQUEST

GET/inbox

Through the GET/inbox it is possible to obtain the list of all emails in the inbox.

{
 "data":[
   {
    "sender": "dev-api@pecmassiva.com",
    "recipient": "dev-api@pecmassiva.com",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "ACCETTAZIONE: Invio di prova pec massiva 2020082610003492",
    "id": 1
   },
   {
    "sender": "\"Per conto di: dev-api@pecmassiva.com\" ",
    "recipient": "dev-api@pecmassiva.com",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492",
    "id": 2
   },
   {
    "sender": "posta-certificata@pecmassiva.com",
    "recipient": "dev-api@pecmassiva.com",
    "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 Massive REM 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).

Sign Up

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!

Frequently Asked Questions

Certified Message Massive Delivery API Service (Flat) allows you to send certified email messages massively, securely and in compliance with AGID regulations.
It does not require the activation of any software and allows you to send up to 30,000 REM per month, up to 100 MB per message.
With the purchase of the Certified Message Massive Delivery API Service (Flat), activation of a mailbox with the @pecmassiva.com domain is included, and there is the possibility of attaching files, but also - on request - of certifying a specific domain and customising the extension (e.g. with the company name).

Please note that the Certified Message Massive Delivery Flat service can currently only be activated from https://www.pecmassiva.com/pec-massiva-api.

What is the Certified Message Massive Delivery API Service (Flat)?

The main difference between Certified Message Massive Delivery Standard and Flat is the sending limit. Certified Message Massive Delivery API Service Standard allows sending up to 3,500 certified email messages per day, whereas Certified Message Massive Delivery API Service Flat allows sending up to 30,000 certified email messages per month. In both cases, it is possible to attach files, and the activation of a Massive mailbox with the domain @pecmassiva.com is included.

With Certified Message Massive Delivery Flat, it is also possible – upon request – to certify a specific domain and customize the extension (e.g., with your company name).

Please note that Certified Message Massive Delivery Flat is currently only available for activation through the website: https://www.pecmassiva.com/pec-massiva-api.

What are the differences between Certified Message Massive Delivery API Service Standard and Flat?

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
Does Certified Message Massive Delivery API Service have legal validity?

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.

Who is the Certified Message Massive Delivery API Service designed for?

The service is delivered within 24 hours.

What are the service processing times?

The annual fee is €1.500 instead of 3.000€.

For the Certified Message Massive Delivery API Service (Flat) there is no cost per sending.

What are the costs of the Certified Message Massive Delivery API Service (Flat)?