PEC Massiva API
Da: €0.02 + IVA
Invia grossi quantitativi di Messaggi di Posta Elettronica Certificata ai tuoi contatti tramite API, nel pieno rispetto delle normative.
PEC Massiva API è la soluzione ideale per chi deve gestire un elevato numero di comunicazioni a valore legale e vuole integrarla direttamente alla propria piattaforma, gestionale o CRM tramite API.
Non richiede l'attivazione di alcun software: basta l'API per inviare messaggi PEC in modo massivo, sicuro e conferme a normativa AGID,
Viene spesso utilizzato insieme al servizio API PEC Company, che permette di recuperare in tempo reale le PEC di qualsiasi azienda italiana.
Il servizio prevede un canone annuo di 99€ ed un importo pari a 0,05€ per singolo messaggio. Con le soluzioni in abbonamento, invece, è possibile inviare fino a 600.000 messaggi certificati all'anno (estendibile su richiesta), a partire da 0,02€.
L'estensione predefinita della PEC Massiva è @pecmassiva.com, ma è possibile personalizzare il dominio associato alla casella richiamando l'apposito endpoint dedicato alla gestione dei domini, ad esempio utilizzando quello della propria azienda.
Verifica Indirizzo PEC
Per utilizzare la PEC Massiva è necessario prima verificare e attivare la casella dedicata alla PEC Massiva tramite l'API PEC. Come indicato in precedenza è possibile attivare una casella con dominio @pecmassiva.com oppure certificare un proprio dominio di secondo (esempio.com) o terzo livello (pec.esempio.com)
Per verificare la disponibilità dell'indirizzo PEC desiderato è necessario effettuare una richiesta all'endpoint è GET all'endpoint https//pec.openapi.it/verifica_pec/{pec}.
ESEMPIO RICHIESTA
GET/verifica_pec/{pec}
Questo è un esempio di richiesta per verificare la disponibilità dell'indirizzo PEC [email protected]
GET https://pec.openapi.it/verifica_pec/[email protected]ESEMPIO RISPOSTA
GET/verifica_pec/{pec}
La risposta indica se quell'indirizzo è disponibile (avalaible:true) o meno:
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}Registrazione PEC Massiva
ESEMPIO RICHIESTA
POST/pec
Dopo aver accertato la disponibilità della PEC, si può procedere alla registrazione tramite l'endpoint POST/pec . Il body della richiesta deve includere i seguenti dati:
- nome della casella
- tipologia cliente (es. PV per privato)
- dati anagrafici del richiedente (Nome e Cognome o Denominazione, codice fiscale o P.IVA richiedente, data e luogo di nascita, indirizzo residenza o sede legale)
Questo è un esempio di Payload con tutti i dati da passare:
{
"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"
}
}In fase di richiesta è possibile anche attivare il rinnovo automatico aggiungendo al body il parametro facoltativo "autorinnovo" con valore 'true' (attualmente è di default 'false').
ESEMPIO RISPOSTA
POST/pec
La risposta contiene una serie di informazioni tra cui il riepilogo delle caratteristiche della PEC, lo stato di attivazione e l'ID che sarà fondamentale per i prossimi passaggi di attivazione, per verificarne lo stato ed in futuro per procedere al rinnovo.
{
"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
}Attivazione Casella PEC Massiva
ESEMPIO RICHIESTA
PATCH/pec/{id}/attivazione
Per completare l'attivazione è necessario scaricare la modulistica richiesta (GET /pec/{id}/modulo_attivazione) e inviare il modulo compilato e firmato insieme al documento di identità del richiedente tramite l'endpoint PATCH/pec/{id}/attivazione. L'id da utilizzare è quello ottenuto nella risposta precedente.
ESEMPIO RISPOSTA
PATCH/pec/{id}/attivazione
La risposta è la seguente:
{
"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
}Verifica stato Attivazione PEC Massiva
ESEMPIO RICHIESTA
GET/pec/{id}
E' possibile verificare lo stato di attivazione della PEC tramite l'endpoint GET/pec/{id}. Nell'esempio precedente per controllare la casella è necessario passare l'id 6040e4613a716838dc4eee0e e sarà:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0eESEMPIO RISPOSTA
GET/pec/{id}
Questo è un esempio di risposta in cui la casella risulta correttamente registrata:
{
"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
}NOTA BENE: Attualmente la verifica è possibile solo per i clienti che hanno attivato la PEC Massiva tramite API e non tramite il sito www.pecmassiva.com.
Registrazione ed attivazione della PEC Massiva avvengono tramite l'API PEC (https://pec.openapi.it); la gestione della casella, come ad esempio l'invio dei messaggi e la verifica degli invii, è invece affidata ad un'altra API specifica: API Posta Massiva (https://ws.pecmassiva.com).
Una volta attivata la casella PEC massiva è possibile iniziare ad inviare i messaggi tramite messaggio singolo o threads.
Invio di Messaggi PEC
L'endpoint POST/send consentedi inviare un messaggio certificato ad uno o più destinatari, con la possibilità di aggiungere anche allegati.
ESEMPIO RICHIESTA
Per inviare un messaggio PEC è necessario passare nel payload i dati richiesti: indirizzo email destinatario, oggetto, testo, allegati, username e password
POST/send
{
"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 caso di più destinatari il payload deve includere un array con gli indirizzi dei destinatari.
ESEMPIO RISPOSTA
POST/send
La risposta all'invio è un codice identificativo della spedizione che può essere utilizzato per restituire le informazioni sulla conferma di ricezione e le email di consegna.
{
"success": true,
"sent": 1,
"message": "",
"message_id": "2020082610003492"
}
Creazione Theads
POST/threads
Oltre ad inviare un singolo messaggio PEC, l'API PEC Massiva consente anche di creare un thread: una conversazione tracciata in cui il messaggio PEC viene associato alle risposte e ai messaggi successivi, consultabili poi nel loro insieme. Per creare un thread ed inviare il primo messaggio PEC l'endpoint da utilizzare è POST/threads
ESEMPIO RICHIESTA
POST/threads
Nel payload della richiesta deve essere passato l'indirizzo email del destinatario, l'oggetto, il testo del massaggio, eventuale allegato e username e password:
{
"recipient": "[email protected]",
"subject": "Invio di prova pec massiva",
"body": "Salve, questa rappresenta una prova di threads, che prevede un corpo in html",
"attachments": [
{
"name": "allegato1.png",
"file": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAAAGX="
}
],
"username": "your_pec_username",
"password": "your_pec_password"
}
ESEMPIO RISPOSTA
POST/threads
La risposta della creazione del threads include, tra l'altro, l'id del thread, l'id messaggio e lo stato di invio. L'Id thread è utile per recuperare una conversazione specifica e tutti i messaggi ad essa associata (GET /threads/{id}) o per inviare un nuovo messaggio in una discussione precedentemente avviata. L'ID messaggio consente invece di recuperare uno specifico messaggio ed eventualmente allegato presente (GET /threads/{id}/{msgId}).
{
"msgId": "d6650f1a2b3c4d5e6f7081920",
"threadId": "6650f1a2b3c4d5e6f7081920",
"createdAt": "26/08/2026 10:00:35",
"sentAt": "26/08/2026 10:00:35",
"updateAt": "26/08/2026 10:00:35",
"status": "sent",
"subject": "Invio di prova pec massiva",
"sender": "[email protected]",
"recipients": [
"[email protected]",
],
"body": "Salve, questa rappresenta una prova di threads, che prevede un corpo in html",
"attachments"[],
"callback"{}
},
"success": true,
"message": "Operation successful",
"error": null
}
A differenza dell'invio tramite messaggio singolo (/send), l'invio tramite thread consente, in caso di superamento della quota giornaliera, di mettere il messaggio in coda ed evaderlo il giorno successivo.
CONTINUARE UN THREADS
Per continuare una conversazione già avviata è necessario utilizzare l'endpoint dedicato PATCH /threads/{id} utilizzando l'id ottenuto nella risposta alla creazione del threads.
ESEMPIO RICHIESTA
PATCH/threads/{id}
Nel payload vanno passati il contenuto del nuovo messaggio e l'username e password della casella PEC
{
"body": "Salve, questa rappresenta una prova di invio, che prevede un corpo in html",
"username": "your_pec_username",
"password": "your_pec_password"
}ESEMPIO RISPOSTA
PATCH/threads/{id}
{
"msgId": "d6650f1a2b3c4d5e6f7081920",
"threadId": "6650f1a2b3c4d5e6f7081920",
"createdAt": "26/08/2026 10:00:35",
"sentAt": "26/08/2026 10:00:35",
"updateAt": "26/08/2026 10:00:35",
"status": "sent",
"subject": "Invio di prova pec massiva",
"sender": "[email protected]",
"recipients": [
"[email protected]",
],
"body": "Salve, questa rappresenta una prova di threads, che prevede un corpo in html",
"attachments"[],
"callback"{},
"accepted": false,
"acceptedAt": null,
"deliveries": []
},
"success": true,
"message": "Operation successful",
"error": null
}
Lista messaggi ricevuti
GET/inbox
Attraverso l'endpoint GET/inbox è possibile ottenere la lista di tutte le email ricevute presenti nell'inbox.
ESEMPIO RICHIESTA
Nella richiesta è necessario passare username e passwords della casella nell'header, inoltre è possibile indicare di suddividere i risultati in pagine o effettuare una ricerca tramite il parametro "q".
{
"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
}
Lista messaggi ricevuti non aperti
GET/inbox/unread
L'endpoint GET/inbox/unread consente invece di ottenere la lista di tutte le email ricevute presenti nell'inbox ma non aperte.
{
"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
}
Verifica utilizzo PEC
Per verificare la quota di utilizzo della PEC e il limite, assoluto o giornaliero, è necessari utilizzare il seguente endpoint GET/quota. E' necessario passare nell'header username e password della casella PEC Massiva.
ESEMPIO RISPOSTA
GET/quota
La risposta indica l'utilizzo (usage) e quali sono le dimensioni totali (limit) dell'Inbox. I dati sono espressi in megabyte.
{
"data": {
"usage": 171012,
"limit": 1048576,
"dailyUsage":{
"used": 120,
"limit": 3500
"remaining": 3380
}
},
"success": true,
"message": "",
"error": null
}I servizi di PEC Massiva ad oggi vengono utilizzati da decide di aziende, pubbliche e private, di settori completamente differenti (come Energia, Recupero Credito, Servizi Ambientali, Marketing, Consorzi, Istituti di Pagamenti, Uffici Gari e appalti, Industrie), che hanno la necessità di gestire un grande volume di comunicazioni valide legalmente e tracciabili (ad es. documenti ufficiali e contratti).
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
PEC Massiva è il servizio che permette di inviare - tramite API - messaggi PEC legalmente validi (con eventuali allegati), in modo massivo e sicuro.
Non prevede l'attivazione di alcun software e consente di gestire un elevato numero di comunicazioni secondo normativa AGID, a costi molto competitivi e con la possibilità di attivare l'abbonamento annuale per risparmiare sui singoli invii.
Sì, ha piena validità legale (secondo normativa AGID) e ha lo stesso valore di una Raccomandata A/R. Questo la rende uno strumento efficace e sicuro per comunicazioni ufficiali, come notifiche, contratti o comunicazioni aziendali formali.
I messaggi inviati tramite la propria casella PEC (Posta Elettronica Certificata) garantiscono:
- certezza della consegna (viene fornita infatti conferma dell’invio e ricezione del messaggio)
- integrità del contenuto (viene assicurato che il contenuto non è stato alterato durante la trasmissione)
- validità temporale (si certifica la data e l'ora in cui il messaggio è stato inviato e ricevuto)
La PEC Massiva ha le seguenti dimensioni:
- 1 GB Spazio inbox
- 1 GB Archivio di sicurezza
Sì, è possibile scegliere e personalizzare il dominio associato alla casella PEC richiamando l'apposito endpoint dedicato alla gestione dei domini. Ad esempio, puoi utilizzare il dominio della tua azienda anziché quello predefinito.
Sì, tramite l'apposito endpoint dedicato alla gestione dei domini è possibile selezionare e associare un dominio certificato personalizzato alla PEC Massiva, ad esempio il dominio della propria azienda.
Sì, il servizio PEC Massiva via API consente di allegare file e documenti prima dell’invio.
PEC Massiva è pensata per aziende e organizzazioni che hanno bisogno di gestire un grande volume di comunicazioni valide legalmente e tracciabili, ad es. documenti ufficiali e contratti. L’integrazione via API è la soluzione ideale in questi casi in quanto il processo è automatico, veloce, efficiente. Senza intervento manuale infatti è possibile ridurre al minimo il rischio di errori.
L'endpoint `POST /send` consente di inviare un singolo messaggio senza creare una conversazione tracciabile.
L'endpoint `POST /threads`, invece, consente di creare e gestire una conversazione tracciabile. Tramite gli endpoint dedicati al thread è possibile accedere all'intera conversazione, inclusi i messaggi inviati e ricevuti, mantenendo lo storico della comunicazione.
Esiste inoltre una differenza nella gestione del limite giornaliero di invio. Se il limite è stato raggiunto:
- con `POST /threads` (e le relative operazioni `POST` o `PATCH`), il messaggio viene messo in coda e sarà inviato automaticamente quando il limite giornaliero verrà ripristinato;
- con `POST /send`, invece, la richiesta restituisce un errore e il messaggio non viene messo in coda.
Sì, il servizio prevede di default un limite massimo di 3.500 messaggi al giorno. Se hai esigenze di invio superiori, puoi contattarci per valutare un aumento del limite.
Il servizio viene erogato in 24ore.
Il servizio PEC Massiva prevede un costo di attivazione annuale di 99€.
Per l'utilizzo a consumo, ogni invio ha un costo di 0,05€ per singola chiamata API.
In alternativa, sono disponibili piani in abbonamento annuale che consentono di ridurre il costo per invio, a partire da 0,02€ per chiamata API, in base al volume di traffico incluso nel piano.
Energia pulita per il nostro cloud 
Low CO2
Openapi SpA Unipersonale - Società sottoposta a direzione e controllo della Open Holding Srl - Viale Filippo Tommaso Marinetti 221 - 00143 Roma - REA 1378273 Cap. Soc. € 50.000,00 i.v. – P.I. IT12485671007 - CODICE DESTINATARIO 'USAL8PV' - PEC: 
Openapi è certificata: Sistema qualità UNI EN ISO 9001:2015 - Qualità dei Dati ISO 25012:2014 - Gestione della Sicurezza ISO/IEC 27001:2022 - Parità di Genere UNI PdR 125:2022
Tutti i prezzi sono da considerarsi al netto di eventuale IVA, eventuali imposte di bollo, diritti di segreteria e/o imposte o tasse altrimenti denominate se dovute. Tutti i loghi elencati nel portale sono coperti da copyright e di proprietà dei rispettivi proprietari.
