The easiest and most secure solution for sending your Massive CEMs
Manage and automate the sending of large quantities of Certified Electronic Mail messages via API
The Massive CEM options on Openapi are:
- Massive CEM API Standard
The standard solution allows you to send up to 3.500 messages per day and includes the activation of a Certified Email box with the @pecmassiva.com domain. The cost per message is 0,05€ - Massive CEM API FLAT
The FLAT solution allows you to send up to 30.000 CEMs per month, included in the price. It also includes the Certified Domain (e.g. @openapi.com).
The Massive CEM FLAT is currently only available on the following website: https://www.pecmassiva.com/pec-massiva-api
To check the availability of the desired Certified Email address, a request must be made to the GET /pec.openapi.it/verifica_pec/{pec} endpoint.
The request must specify the Certified Email address whose availability is to be checked.
The response indicates whether the address is available (if positive, the message is 'true', if negative, it is 'false').
Once you have ascertained the availability of the PEC address, you can proceed with its registration via the POST endpoint https://pec.openapi.it/pec.
The data to be passed in the body of the request are:
- certified email box
- box type
- customer type and sub-type
- information on the applicant (name and surname, email and telephone, tax code, date of birth, gender, country and province of birth)
- name and tax/VAT code of the holder of the email
- holder's full address (street, municipality, postal code, country, province)
- any callback url set
You may also activate auto-renewal by adding the optional 'auto-renewal' parameter with the value 'true' to the body (currently the default is 'false').
The response will contain a series of information including a summary of the characteristics of the CEM. The activation status of the CEM and the id are also specified.
The id will be crucial for the next activation steps, for checking the status and for renewal.
You can complete the PEC activation via the PATCH /pec/{id}/attivazione endpoint.
To complete this operation you must download the required form (GET /pec/{id}/modulo_attivazione) and proceed to send the form, correctly filled in and signed together with the applicant's ID. It must be a single document and in PDF format.
The id is the one obtained in the previous endpoint (POST /pec.openapi.it/pec).
Currently you can purchase and activate your subscription to Massive CEM FLAT exclusively from the dedicated website PEC MASSIVA.
Yes, you can check the status of your Certified Email Messages at any time via the GET /pec/{id} endpoint and from the CEM's id value.
The response provides a lot of information. First the status of the Certified Email (e.g. registrata=registered) and then other information such as:
- owner of the CEM
- domain
- registration date
- available storage space
- any callback url set
PLEASE NOTE: Currently verification is only possible for customers who have activated via API and not via www.pecmassiva.com. This endpoint is not valid for verifying the status of the FLAT Massive CEM.
It is possible to send Certified Email via API via the POST /send endpoint.
Recipients can be single or multiple and the starting parameters are:
- sender (sender)
- recipient
- object
- message body (message)
- attachments (attachment name and file)
- CEM username
- CEM password
The reply returns the sending identification code (message id), which will be useful later on for receiving and delivery confirmation e-mails.
PLEASE NOTE: this endpoint can handle up to 1 request/second.
Yes, it is possible to view the status of received e-mails and to check their delivery, via the GET /send/{code} endpoint.
The starting parameters are:
- username of the email to be checked
- password of the email to be checked
- code returned when the PEC was sent (message id)
The reply provides information on:
- sender
- recipient
- sending date
- object
- message body
Yes, it is possible to do so via the DELETE /send/{code} endpoint.
The starting parameters are:
- username of the email to be checked
- password of the e-mail to be checked
- code returned when the Certified Email was sent (message id)
The reply indicates whether the operation was successful with the following messages:
- 'Operation successfull' if positive
- Authorization in not valid or empty' in a negative case
Yes, the GET /inbox endpoint returns the contents of your inbox from the parameters
- username of the email to be checked (mandatory)
- password of the email to be checked (mandatory)
- q - search criteria (optional)
- page - current page (optional)
Using the q parameter, it is possible to search for messages in the inbox. The results can be paged and each page contains up to 25 messages.
The response provides information on:
- sender (sender)
- recipient (recipient)
- date sent
- object
- id
The unique id can later be used to obtain the individual message or delete it.
Yes, it is possible to display individual messages in the inbox via the GET /inbox/{id} endpoint.
The starting parameters are:
- username of the email to be checked
- password of the e-mail to be checked
- id of the message received from inbox
The response provides information on:
- sender
- recipient
- sending date
- object
- message body (message)
Yes, you can do this via the DELETE /inbox/{id} endpoint.
The starting parameters are:
- username of the email to be checked
- password of the email to be checked
- id of the message received from inbox
The response indicates whether the operation was successful with the following messages:
- 'Message deleted' in a positive case
- Authorization is not valid or empty' in a negative case
Yes, you can be informed about the usage quota (in megabytes) of your inbox.
The starting parameters are:
- username of the email to be checked
- password of the e-mail to be checked
- mailbox: the mailbox to be checked. One can use 'inbox' to check the status of the main mailbox.
The answer provides information on:
- usage quota
- total size limits of the inbox
The activation time for Massive CEM is 24 hours.
For Massive CEM API Standard the activation cost is 99€, plus the cost of sending a single message of 0.05€.
For Massive CEM API Flat the cost is 1,500€ and includes 30,000 Certified Email sendings per month.
Massive CEM FLAT includes in the activation cost 30,000 items per month.
For Massive Standard CEM the cost is €0.05 per individual message.
In the Usage section, at the API level, you can monitor your free and top-up requests. They are available both graphically (period month and year) and with a textual summary.