Pec (Posta Elettronica Certificata) (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Web services for the activation and management of Certified Email (PEC). These services allow you to register a new certified mailbox, as well as renew or revoke existing accounts. You can also modify mailbox options such as total storage and archive space, or enable and expand legally compliant preservation. Furthermore, the system includes methods to report a certified email address to the Business Register. Finally, you can use these services to download and upload activation forms for both the mailbox and the legal preservation service.

First time here? Generate a new access token

Pec

Methods that allow you to register, activate and modify a certified e-mail

Domain check

This method allows you to check if a domain is eligible for sending or receiving a pec

Authorizations:

bearerAuth

path Parameters

dominio

required

string

Default: "<string>"

Example: legalmail.it

Domain

Responses

Response Schema: application/json

data	Array of strings
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/domini_pec/%7Bdominio%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
402
406
428
503

Content type

application/json

{"data": [ ],
"success": true,
"message": "legalmail.it found!",
"error": null
}

Availability of a certified e-mail box

This method shows you the availability of a certified e-mail box

Authorizations:

bearerAuth

path Parameters

pec

required

string

Default: "<string>"

Example: [email protected]

Email box

Responses

Response Schema: application/json

	object
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/verifica_pec/%7Bpec%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
406
428

Content type

application/json

{"data": {"available": true
},
"success": true,
"message": "",
"error": null
}

List of your certified e-mail boxes

This method shows you the list of certified e-mail boxes that belong to your account

Authorizations:

bearerAuth

query Parameters

skip	integer Default: "<integer>" Example: skip=0 Optional. Number of items to skip for pagination. If not specified, the default value is 0.
limit	integer Default: "<integer>" Example: limit=100 Optional. Maximum number of items to return. If not specified, the default value is 100.

Responses

Response Schema: application/json

	Array of objects (Caselle) [ items ]
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/pec?skip=0&limit=100");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
404

Content type

application/json

{"data": [{"id": "6040e4613a716838dc4eee0e",
"casella_pec": "[email protected]",
"tipo_casella": "BRONZE",
"stato": "revocata",
"data_scadenza": "04/03/2022",
"timestamp": {"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614868312,
"scadenza": 1646391493,
"revoca": 1614868400
},
"owner": "[email protected]"
},
{"id": "6040c9df3a716838dc4eede4",
"casella_pec": "[email protected]",
"tipo_casella": "STANDARD",
"stato": "evasa",
"data_scadenza": "04/03/2022",
"timestamp": {"registrazione": 1614858718,
"ultima_modifica": 1614859181,
"evasione": 1614859181,
"scadenza": 1646391493
},
"owner": "[email protected]"
}
],
"success": true,
"message": "",
"error": null
}

Register a new certified mailbox

This method allows you to register a new certified mailbox.

If you do not have your own certified domain, the mailbox must necessarily consist of:

'box_name'@legalmail.it (Es. provapec@legalmail.it) for STANDARD, BRONZE, SILVER AND GOLD mailbox;
'box_name'@domiciliodigitale.com (Es. provapec@domiciliodigitale.com) for DOMICILIODIGITALE box;
'box_name'@pecmassiva.com (Es. provapec@pecmassiva.com) for PECMASSIVA box.

In Sandbox must be: 'box_name'@testcert.legalmail.it (Es. provapec@testcert.legalmail.it) or 'box_name'@test.domiciliodigitale.com (Es. provapec@test.domiciliodigitale.com).

Authorizations:

bearerAuth

Request Body schema: application/json

casella_pec required	string Default: "<string>" the certified email address (PEC)
tipo_casella required	string Default: "<string>" Enum: "STANDARD" "BRONZE" "SILVER" "GOLD" "DOMICILIODIGITALE" "PECMASSIVA" type of mailbox
tipo_cliente required	string Default: "<string>" Enum: "IM" "PS" "PL" "PC" "A" "PV" "X" the customer type
sottotipo_cliente	string Default: "<string>" Enum: "SI" "IN" "CM" "TE" "ES" "ME" "AL" "CF" "ED" "TM" "MA" "AR" "TL" "FI" "X" "PC" "PR" "PN" "PT" "PA" "PL" "LR" "LP" "LC" "LM" "LA" "LI" the customer subtype
sottotipo_cliente_altro	string Default: "<string>" other customer subtype
nome_richiedente required	string Default: "<string>" first name of the applicant
cognome_richiedente required	string Default: "<string>" last name of the applicant
email required	string Default: "<string>" standard email address of the applicant
telefono required	string Default: "<string>" phone number of the applicant
cellulare	string Default: "<string>" mobile phone number of the applicant
codice_fiscale_richiedente required	string Default: "<string>" fiscal code of the applicant
data_nascita_richiedente required	string Default: "<string>" date of birth of the applicant
sesso_richiedente required	string Default: "<string>" Enum: "M" "F" gender of the applicant
nazione_nascita_richiedente required	string Default: "<string>" country of birth of the applicant
comune_nascita_richiedente	string Default: "<string>" city of birth of the applicant
provincia_nascita_richiedente	string Default: "<string>" province of birth of the applicant
denominazione_titolare	string Default: "<string>" name of the mailbox holder
cf_piva_titolare	string Default: "<string>" fiscal code or VAT number of the mailbox holder
indirizzo_titolare required	string Default: "<string>" address of the mailbox holder
comune_titolare required	string Default: "<string>" city of the mailbox holder
cap_titolare required	string Default: "<string>" postal code (CAP) of the mailbox holder
nazione_titolare required	string Default: "<string>" country of the mailbox holder
provincia_titolare required	string Default: "<string>" province of the mailbox holder
	object (Callback)
autorinnovo	boolean Default: false if set to true, it allows the system to renew the account automatically upon expiration, trying to withdraw credit from the owner's purse
tipo_documento	string Default: "<string>" Enum: "CARTA_D_IDENTITA" "PATENTE" "PASSAPORTO" type of identification document
numero_documento	string Default: "<string>" number of the document
data_scadenza_documento	string Default: "<string>" expiration date of the document
documento_rilasciato_da	string Default: "<string>" issuing authority of the document
data_rilascio_documento	string Default: "<string>" Issue date of the document

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"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",
"field": "data"
}
}

Response samples

200
402
404
406
428

Content type

application/json

{"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",
"field": "data",
"method": "POST",
"data": { }
},
"dominio": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {"registrazione": 1615199724,
"ultima_modifica": 1615199726
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10174594",
"uid": "MA178634",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 0,
"spazio_storico": 0,
"stato": "registrata",
"storico": false,
"id": "6045fdee3a716847a978a471",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}

Specific certified e-mail address

This method shows you the specific certified e-mail address related to the id

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6040e4613a716838dc4eee0e

Pec id

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/pec/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
400
404

Content type

application/json

{"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",
"field": "data",
"method": "POST",
"data": { }
},
"dominio": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614868312,
"scadenza": 1646391493,
"revoca": 1614868400
},
"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": "revocata",
"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
}

Pec revocation

This method allows you to revoke the specific certified e-mail address related to the id

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6040e4613a716838dc4eee0e

Pec id

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/pec/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
400
404
406
428

Content type

application/json

{"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",
"field": "data",
"method": "POST",
"data": { }
},
"dominio": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614868312,
"scadenza": 1646391493,
"revoca": 1614868400
},
"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": "revocata",
"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
}

Certified e-mail activation

This method allows you, once you have registered your certified electronic mailbox, to activate it by uploading the necessary documentation. The required documentation includes your valid identity document and the completed and signed activation form that you can download using the method GET/pec/{id}/modulo_attivazione. For the boxes of type DOMICILIODIGITALE and PECMASSIVA it is necessary to create a single document comprising the signed activation form and the identity document.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6045fdee3a716847a978a471

Pec id

Request Body schema: application/json

string or Array of strings

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"documenti": ["JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ",
"JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAw"
]
}

Response samples

200
400
404
406
428

Content type

application/json

{"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",
"field": "data",
"method": "POST",
"data": { }
},
"dominio": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {"registrazione": 1615199724,
"ultima_modifica": 1615200175
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10174594",
"uid": "MA178634",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 0,
"spazio_storico": 0,
"stato": "in_evasione",
"storico": false,
"documenti_attivazione": ["6045fdee3a716847a978a471_0_attivazione.pdf",
"6045fdee3a716847a978a471_1_attivazione.pdf"
],
"id": "6045fdee3a716847a978a471",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}

Change mailbox space

This method allows you to change the space of a certified e-mail. You can change the disk space('spazio_disco'), the security archive space('spazio_storico') and the standard storage space('spazio_conservazione'). Only a space upgrade is allowed. Action not allowed for these two types of boxes: DOMICILIODIGITALE, PECMASSIVA.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6045fdee3a716847a978a471

Pec id

Request Body schema: application/json

	string or integer If you put the + symbol in front you go to add space to what you have. If you pass only a number go to set the space with that value.
	string or integer If you put the + symbol in front you go to add space to what you have. If you pass only a number go to set the space with that value.
	string or integer If you put the + symbol in front you go to add space to what you have. If you pass only a number go to set the space with that value.

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"spazio_disco": "3072",
"spazio_storico": "+1024",
"spazio_conservazione": 1536
}

Response samples

Content type

application/json

{"data": {"casella_pec": "[email protected]",
"tipo_casella": "GOLD",
"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": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {"registrazione": 1615199724,
"evasione": 1615199724,
"scadenza": 1646391493,
"ultima_modifica": 1615200175
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10174594",
"uid": "MA178634",
"conservazione": true,
"data_attivazione": "20/04/2021",
"data_scadenza": "20/04/2022",
"descrizione": "[email protected]",
"sms": true,
"spazio_conservazione": 1536,
"spazio_disco": 3072,
"spazio_storico": 14336,
"stato": "evasa",
"storico": true,
"documenti_attivazione": ["6045fdee3a716847a978a471_0_attivazione.pdf",
"6045fdee3a716847a978a471_1_attivazione.pdf"
],
"documenti_conservazione": ["6045fdee3a716847a978a471_0_conservazione.pdf"
],
"id": "6045fdee3a716847a978a471",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}

Activation of conservation according to law

This method allows you to activate the standard storage service in your certified e-mail. Action not allowed for these two types of boxes: DOMICILIODIGITALE, PECMASSIVA.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6045fdee3a716847a978a471

Pec id

Request Body schema: application/json

	string or integer If this parameter is not passed it is set to 512 by default
required	string or Array of strings

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"spazio_conservazione": 1024,
"documenti": "JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"
}

Response samples

Content type

application/json

{"data": {"casella_pec": "[email protected]",
"tipo_casella": "GOLD",
"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": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {"registrazione": 1615199724,
"evasione": 1615199724,
"scadenza": 1646391493,
"ultima_modifica": 1615200175
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10174594",
"uid": "MA178634",
"conservazione": true,
"data_attivazione": "20/04/2021",
"data_scadenza": "20/04/2022",
"descrizione": "[email protected]",
"sms": true,
"spazio_conservazione": 1024,
"spazio_disco": 2048,
"spazio_storico": 13312,
"stato": "evasa",
"storico": true,
"documenti_attivazione": ["6045fdee3a716847a978a471_0_attivazione.pdf",
"6045fdee3a716847a978a471_1_attivazione.pdf"
],
"documenti_conservazione": ["6045fdee3a716847a978a471_0_conservazione.pdf"
],
"id": "6045fdee3a716847a978a471",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}

Change box type

This method allows you to change the type of certified email. Only upgrades are allowed, for example from a STANDARD you can switch to a SILVER or GOLD one. Action not allowed for these two types of boxes: DOMICILIODIGITALE, PECMASSIVA.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6045fdee3a716847a978a471

Pec id

Request Body schema: application/json

tipo_casella

string

Default: "<string>"

Enum: "STANDARD" "BRONZE" "SILVER" "GOLD"

type of mailbox

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"tipo_casella": "GOLD"
}

Response samples

Content type

application/json

{"data": {"casella_pec": "[email protected]",
"tipo_casella": "GOLD",
"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": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {"registrazione": 1615199724,
"evasione": 1615199724,
"scadenza": 1646391493,
"ultima_modifica": 1615200175
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10174594",
"uid": "MA178634",
"conservazione": false,
"data_attivazione": "20/04/2021",
"data_scadenza": "20/04/2022",
"descrizione": "[email protected]",
"sms": true,
"spazio_conservazione": 0,
"spazio_disco": 2048,
"spazio_storico": 13312,
"stato": "evasa",
"storico": true,
"documenti_attivazione": ["6045fdee3a716847a978a471_0_attivazione.pdf",
"6045fdee3a716847a978a471_1_attivazione.pdf"
],
"id": "6045fdee3a716847a978a471",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}

Renewal of certified e-mail

This method allows you to renew for one year or re-activate the certified e-mail identified by the id

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6040e4613a716838dc4eee0e

Pec id

query Parameters

anni	integer Default: "<integer>" Example: anni=2 Number of years for which you want to renew the pec box. If not passed it is 1 by default

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/pec/%7Bid%7D/rinnovo?anni=2");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
400
404
428

Content type

application/json

{"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",
"field": "data",
"method": "POST",
"data": { }
},
"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
}

Add user

This method allows you to add a user who can use an existing pec box. It can only be activated on STANDARD, BRONZE, SILVER, and GOLD mailboxes.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 6040e4613a716838dc4eee0e

Pec id

Request Body schema: application/json

nome required	string Default: "<string>" first name
cognome required	string Default: "<string>" last name
descrizione required	string Default: "<string>" description
email_gestione_password required	string Default: "<string>" email of the user

Responses

Response Schema: application/json

	object (Casella)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"nome": "luca",
"cognome": "bianchi",
"descrizione": "prima utenza",
"email_gestione_password": "[email protected]"
}

Response samples

Content type

application/json

{"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",
"field": "data",
"method": "POST",
"data": { }
},
"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
}

Comunica Pec

Methods that allow you to communicate a certified e-mail to the business register

List of your communications

This method shows you all the certified e-mail communications to the business register started

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects (RichiesteComunicazionePec) [ items ]
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/comunica_pec");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
404

Content type

application/json

{"data": [{"id": "60ad149c3a7168084f1d2b68",
"casella_pec": "[email protected]",
"stato": "comunicazione_evasa",
"timestamp": 1622127248,
"owner": "[email protected]"
},
{"id": "60ad0f2a3a716801f42a9773",
"casella_pec": "[email protected]",
"stato": "comunicazione_evasa",
"timestamp": 1622126850,
"owner": "[email protected]"
}
],
"success": true,
"message": "",
"error": null
}

Communicate a certified e-mail

This method allows you to communicate a certified e-mail to the business register

Authorizations:

bearerAuth

Request Body schema: application/json

casella_pec required	string Default: "<string>" the certified email address (PEC)
cf required	string Default: "<string>" fiscal code
nome required	string Default: "<string>" first name
cognome required	string Default: "<string>" last name
qualifica required	string Default: "<string>" Enum: "AMMINISTRATORE" "COMMISSARIO_GIUDIZIARIO" "CURATORE_FALLIMENTARE" "LEGALE_RAPPRESENTANTE" "LIQUIDATORE" "SOCIO" "TITOLARE" qualification of the owner
email required	string Default: "<string>" email of the owner
cellulare required	string Default: "<string>" mobile phone of the owner
ragione_sociale required	string Default: "<string>" company name
cf_piva required	string Default: "<string>" company's fiscal code or VAT number
comune required	string Default: "<string>" municipality of the company
provincia required	string Default: "<string>" province of the company
	object (Callback)

Responses

Response Schema: application/json

	object (RichiestaComunicazionePec)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"casella_pec": "[email protected]",
"cf": "RSSMRA80A01L117D",
"nome": "mario",
"cognome": "rossi",
"qualifica": "LEGALE_RAPPRESENTANTE",
"email": "[email protected]",
"cellulare": "34xxxxxx18",
"ragione_sociale": "azienda test",
"cf_piva": "12345678910",
"comune": "roma",
"provincia": "RM"
}

Response samples

200
402
406
428

Content type

application/json

{"data": {"casella_pec": "[email protected]",
"cf": "RSSMRA80A01L117D",
"nome": "mario",
"cognome": "rossi",
"qualifica": "LEGALE_RAPPRESENTANTE",
"email": "[email protected]",
"cellulare": "34xxxxxx18",
"ragione_sociale": "azienda test",
"cf_piva": "12345678910",
"comune": "roma",
"provincia": "RM",
"callback": false,
"stato": "codice_in_richiesta",
"codice_registro_imprese": "openapi",
"documenti_registro_imprese": [ ],
"owner": "[email protected]",
"timestamp": 1621955739,
"id": "60ad149c3a7168084f1d2b68"
},
"success": true,
"message": "",
"error": null
}

Specific request for communication pec

This method returns you the specific request marked with the id

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 60ad149c3a7168084f1d2b68

Comunica Pec id

Responses

Response Schema: application/json

	object (RichiestaComunicazionePec)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/comunica_pec/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
400
404

Content type

application/json

{"data": {"casella_pec": "[email protected]",
"cf": "RSSMRA80A01L117D",
"nome": "mario",
"cognome": "rossi",
"qualifica": "LEGALE_RAPPRESENTANTE",
"email": "[email protected]",
"cellulare": "349xxxxx18",
"ragione_sociale": "azienda test",
"cf_piva": "12345678910",
"comune": "roma",
"provincia": "RM",
"callback": false,
"stato": "comunicazione_evasa",
"codice_registro_imprese": "openapi",
"documenti_registro_imprese": ["60ad149c3a7168084f1d2b68_0_registro_imprese.p7m"
],
"owner": "[email protected]",
"timestamp": 1622127248,
"id": "60ad149c3a7168084f1d2b68"
},
"success": true,
"message": "",
"error": null
}

Upload the documents

This method allows you to complete the request for communication of your pec to the business register by uploading the necessary documentation. The required documentation includes the completed and digitally signed in p7m format form that you can download using the method GET/comunica_pec/{id}/procura_registro_imprese.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 60dc8da86c8b04624536bbb2

Comunica Pec id

Request Body schema: application/json

string or Array of strings

Responses

Response Schema: application/json

	object (RichiestaComunicazionePec)
success	boolean Operation success (true/false).
message	string error message
error	integer error code

Request samples

Content type

application/json

{"documenti": "JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"
}

Response samples

200
400
404
406
428

Content type

application/json

{"data": {"casella_pec": "[email protected]",
"cf": "RSSMRA80A01L117D",
"nome": "mario",
"cognome": "rossi",
"qualifica": "LEGALE_RAPPRESENTANTE",
"email": "[email protected]",
"cellulare": "34xxxxx018",
"ragione_sociale": "azienda test",
"cf_piva": "12345678910",
"comune": "roma",
"provincia": "RM",
"callback": false,
"stato": "documenti_caricati",
"codice_registro_imprese": "openapi",
"documenti_registro_imprese": ["60dc8da86c8b04624536bbb2_0_registro_imprese.p7m"
],
"owner": "[email protected]",
"timestamp": 1625067055,
"id": "60dc8da86c8b04624536bbb2"
},
"success": true,
"message": "",
"error": null
}

Domini

Methods that allow you to activate and modify a certified domain

List all domains associated with the account

Authorizations:

bearerAuth

Responses

Response Schema: application/json

Array of objects (Dominio) <= 2 items [ items ]

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/dominio");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
404

Content type

application/json

{"data": [{"id": "69806bcce09fb76c6b0fef0b",
"dominio": "testdominio.legalmail.it",
"fornitore": "infocert",
"owner": "[email protected]",
"stato_fornitore": "OK",
"dns": "OK",
"config": "OK",
"certif": "MISSING",
"tipo_dominio": "interno",
"stato": "registrato",
"data_scadenza": "02/02/2027",
"data_certificazione": "02/02/2026",
"timestamp": {"registrazione": 0,
"ultima_modifica": 0,
"evasione": 0,
"certificazione": 0,
"scadenza": 0,
"revoca": 0
},
"id_ordine": "62558f",
"autorinnovo": false,
"anni": 1,
"numero_pec": 1,
"callback": {"method": "POST",
"field": "<string>",
"url": "https://www.mysite.it/callback.php",
"data": "<object>"
}
}
]
}

Activate a new certified domain

Authorizations:

bearerAuth

Request Body schema: application/json

dominio required	string Default: "<string>" The domain name to activate (e.g. example.com)
	object (Callback)
fornitore required	string Default: "<string>" Enum: "infocert" "namirial" The service provider
anni	integer Default: 1 Enum: 1 2 3 4 5 6 7 8 9 10 Number of years for which the domain is purchased
numero_pec	integer Default: 1 Number of PEC boxes purchased for the domain

Responses

Response Schema: application/json

object (Dominio)

Request samples

Content type

application/json

{"dominio": "testdominio.legalmail.it",
"callback": {"method": "POST",
"field": "<string>",
"url": "https://www.mysite.it/callback.php",
"data": "<object>"
},
"fornitore": "infocert",
"anni": 1,
"numero_pec": 1
}

Response samples

200
406
428

Content type

application/json

{"data": {"dominio": "testdominio.legalmail.it",
"fornitore": "infocert",
"owner": "[email protected]",
"stato_fornitore": "KO",
"dns": "OK",
"config": "KO",
"certif": "KO",
"tipo_dominio": "interno",
"stato": "registrato",
"data_scadenza": "02/02/2027",
"timestamp": {"registrazione": 1770023882,
"scadenza": 1801559882,
"ultima_modifica": 1770023884
},
"anni": 1,
"numero_pec": 1,
"id_ordine": "62558f",
"autorinnovo": false,
"callback": {"url": "https://www.mysite.it/callback.php",
"method": "POST",
"field": "string"
},
"id": "69806bcce09fb76c6b0fef0b"
}
}

Get details of a specific domain

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 69806bcce09fb76c6b0fef0b

The domain ID

Responses

Response Schema: application/json

object (Dominio)

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/dominio/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
404

Content type

application/json

{"data": {"dominio": "testdominio.legalmail.it",
"fornitore": "infocert",
"owner": "[email protected]",
"stato_fornitore": "OK",
"dns": "OK",
"config": "OK",
"certif": "OK",
"tipo_dominio": "interno",
"stato": "evaso",
"data_scadenza": "02/02/2027",
"timestamp": {"registrazione": 1770023882,
"scadenza": 1801559882,
"ultima_modifica": 1770023884,
"certificazione": 1770023884
},
"anni": 1,
"numero_pec": 1,
"id_ordine": "62558f",
"autorinnovo": false,
"callback": {"url": "https://www.mysite.it/callback.php",
"method": "POST",
"field": "data"
},
"data_certificazione": "03/03/2026",
"id": "69806bcce09fb76c6b0fef0b"
}
}

Revoke a certified domain

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 69806bcce09fb76c6b0fef0b

The domain ID to revoke

Responses

Response Schema: application/json

success	boolean
message	string
	object (Dominio)

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/dominio/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
428

Content type

application/json

{"success": true,
"message": "Domain and associated boxes revoked",
"data": {"dominio": "pec.testgestionale.com",
"fornitore": "infocert",
"owner": "[email protected]",
"stato_fornitore": "OK",
"dns": "OK",
"config": "OK",
"certif": "OK",
"tipo_dominio": "esterno",
"stato": "revocato",
"data_scadenza": "13/03/2054",
"data_certificazione": "13/03/2026",
"timestamp": {"registrazione": 1773401265,
"scadenza": 2657014065,
"ultima_modifica": 1774273311,
"certificazione": 1773401405,
"revoca": 1774273558
},
"autorinnovo": false,
"anni": 1,
"numero_pec": 3,
"id_ordine": "1a54cf",
"callback": {"url": "https://www.mysite.it/callback.php"
},
"id": "69b3f4b1d0747173230c4448"
}
}

Renew a certified domain

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 69806bcce09fb76c6b0fef0b

The domain ID

query Parameters

anni	integer Default: 1 Enum: 1 2 3 4 5 6 7 8 9 10 Number of years for renewal. Default 1.

Responses

Response Schema: application/json

object (Dominio)

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/dominio/%7Bid%7D/rinnovo?anni=SOME_INTEGER_VALUE");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
404
428

Content type

application/json

{"data": {"dominio": "pec.testgestionale.com",
"fornitore": "infocert",
"owner": "[email protected]",
"stato_fornitore": "OK",
"dns": "OK",
"config": "OK",
"certif": "OK",
"tipo_dominio": "esterno",
"stato": "evaso",
"data_scadenza": "13/03/2054",
"data_certificazione": "13/03/2026",
"timestamp": {"registrazione": 1773401265,
"scadenza": 2657014065,
"ultima_modifica": 1774273311,
"certificazione": 1773401405
},
"autorinnovo": false,
"anni": 1,
"numero_pec": 3,
"id_ordine": "1a54cf",
"callback": {"url": "https://www.mysite.it/callback.php"
},
"id": "69b3f4b1d0747173230c4448"
}
}

Modulistica

Methods that allow you to download the forms necessary for the management of certified e-mail boxes

Download the activation form

This method allows you to directly download the activation form of a certified e-mail. Once compiled and signed it will be passed in the form of a base 64 encoded string using the PATCH/pec/{id}/attivazione method together with an identity document.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 5f7b2e323a716857774a4373

request id

Responses

Response Schema: application/pdf

string <binary>

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/pec/%7Bid%7D/modulo_attivazione");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

400
404
428

Content type

application/json

{"success": false,
"message": "Wrong id",
"error": 201,
"data": null
}

Download the activation form

This method allows you to directly download the storage activation form for a certified e-mail. once compiled and signed it will be passed in the form of a base 64 encoded string using the PATCH/pec/{id}/conservazione method together with an identity document.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 5f7b2e323a716857774a4373

request id

Responses

Response Schema: application/pdf

string <binary>

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/pec/%7Bid%7D/modulo_conservazione");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

400
404
428

Content type

application/json

{"success": false,
"message": "Wrong id",
"error": 201,
"data": null
}

Download the power of attorney

This method allows you to download the pec communication form to the business register. Once digitally signed in p7m format it will be passed in the form of a base 64 encoded string using the PATCH/comunica_pec/{id} method.

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 5f7b2e323a716857774a4373

request id

Responses

Response Schema: application/pdf

string <binary>

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/comunica_pec/%7Bid%7D/procura_registro_imprese");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

400
404
428

Content type

application/json

{"success": false,
"message": "Wrong id",
"error": 201,
"data": null
}