Legalmail CEM for sending communications and documents securely and with full legal value
On Openapi you can activate, renew, extend your InfoCert Legalmail and Digital Domicile mailbox space
All the knowledge you need
Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.
Get the token in the appropriate section before you start.
- Oas file url https://console.openapi.com/oas/en/pec.openapi.json
- Fork or import with Postman
- Production domain pec.openapi.it
- Sandbox domain test.pec.openapi.it
-
Production Scopes 12
- GET pec.openapi.it/verifica_pec
- GET pec.openapi.it/pec
- POST pec.openapi.it/pec
- PATCH pec.openapi.it/pec
- DELETE pec.openapi.it/pec
- GET pec.openapi.it/dominio
- POST pec.openapi.it/dominio
- DELETE pec.openapi.it/dominio
- GET pec.openapi.it/comunica_pec
- POST pec.openapi.it/comunica_pec
- PATCH pec.openapi.it/comunica_pec
- GET pec.openapi.it/domini_pec
-
Sandbox Scopes 12
- GET test.pec.openapi.it/verifica_pec
- POST test.pec.openapi.it/pec
- DELETE test.pec.openapi.it/pec
- DELETE test.pec.openapi.it/dominio
- GET test.pec.openapi.it/comunica_pec
- POST test.pec.openapi.it/comunica_pec
- PATCH test.pec.openapi.it/comunica_pec
- GET test.pec.openapi.it/pec
- PATCH test.pec.openapi.it/pec
- GET test.pec.openapi.it/dominio
- POST test.pec.openapi.it/dominio
- GET test.pec.openapi.it/domini_pec
Pec (Posta Elettronica Certificata) (1.0.0)
Web service that allows you to activate a certified e-mail.
Domain check
This method allows you to check if a domain is eligible for sending or receiving a pec
Authorizations:
path Parameters
dominio required | string Example: legalmail.it Domain |
Responses
Response Schema: application/json
data | Array of strings |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "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:
path Parameters
pec required |
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "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:
Responses
Response Schema: application/json
Array of objects (Caselle) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://pec.openapi.it/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
- "data": [
- {
- "id": "6040e4613a716838dc4eee0e",
- "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",
- "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:
Request Body schema: application/json
casella_pec required | string mailbox name |
tipo_casella required | string Enum: "STANDARD" "BRONZE" "SILVER" "GOLD" "DOMICILIODIGITALE" "PECMASSIVA" type of mailbox |
tipo_cliente required | string Enum: "IM" "PS" "PL" "PC" "A" "PV" "X" customer type |
sottotipo_cliente | 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" customer subtype |
sottotipo_cliente_altro | string customer subtype, other |
nome_richiedente required | string customer name |
cognome_richiedente required | string customer surname |
email required | string customer email |
telefono required | string customer telephone |
cellulare | string customer mobile phone |
codice_fiscale_richiedente required | string customer fiscal code |
data_nascita_richiedente required | string customer date of birth (accepted format: dd/mm/yyyy) |
sesso_richiedente required | string Enum: "M" "F" gender |
nazione_nascita_richiedente required | string customer country code |
comune_nascita_richiedente | string customer city |
provincia_nascita_richiedente | string customer province code |
denominazione_titolare | string holder denomination |
cf_piva_titolare | string holder vat number |
indirizzo_titolare required | string holder address |
comune_titolare required | string holder city |
cap_titolare required | string holder postal code |
nazione_titolare required | string holder country code |
provincia_titolare required | string holder province code |
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 Enum: "CARTA_D_IDENTITA" "PATENTE" "PASSAPORTO" type of identity document |
numero_documento | string number of identity document |
data_scadenza_documento | string expiry date of the identity document (accepted format: dd/mm/yyyy) |
documento_rilasciato_da | string institution that issued the identity document |
data_rilascio_documento | string date of issue of the identity document (accepted format: dd/mm/yyyy) |
Responses
Response Schema: application/json
object (Casella) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "tipo_casella": "bronze",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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",
Response samples
- 200
- 402
- 404
- 406
- 428
- "data": {
- "tipo_casella": "BRONZE",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "timestamp": {
- "registrazione": 1615199724,
- "ultima_modifica": 1615199726
- "cellulare": "",
- "comune_nascita_richiedente": "",
- "cod_attivazione": "10174594",
- "uid": "MA178634",
- "conservazione": false,
- "data_scadenza": "",
- "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:
path Parameters
id required | string Example: 6040e4613a716838dc4eee0e Pec id |
Responses
Response Schema: application/json
object (Casella) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": {
- "tipo_casella": "BRONZE",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "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",
- "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",
- "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:
path Parameters
id required | string Example: 6040e4613a716838dc4eee0e Pec id |
Responses
Response Schema: application/json
object (Casella) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": {
- "tipo_casella": "BRONZE",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "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",
- "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",
- "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:
path Parameters
id required | string Example: 6045fdee3a716847a978a471 Pec id |
Request Body schema: application/json
string or Array of strings |
Responses
Response Schema: application/json
object (Casella) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "documenti": [
- "JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ",
- "JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAw"
Response samples
- 200
- 400
- 404
- 406
- 428
- "data": {
- "tipo_casella": "BRONZE",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "timestamp": {
- "registrazione": 1615199724,
- "ultima_modifica": 1615200175
- "cellulare": "",
- "comune_nascita_richiedente": "",
- "cod_attivazione": "10174594",
- "uid": "MA178634",
- "conservazione": false,
- "data_scadenza": "",
- "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:
path Parameters
id required | 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 |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "spazio_disco": "3072",
- "spazio_storico": "+1024",
- "spazio_conservazione": 1536
Response samples
- 200
- 400
- 402
- 404
- 406
- 428
- "data": {
- "tipo_casella": "GOLD",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "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",
- "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:
path Parameters
id required | 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 |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "spazio_conservazione": 1024,
- "documenti": "JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"
Response samples
- 200
- 400
- 402
- 404
- 406
- 428
- "data": {
- "tipo_casella": "GOLD",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "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",
- "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:
path Parameters
id required | string Example: 6045fdee3a716847a978a471 Pec id |
Request Body schema: application/json
tipo_casella | string Enum: "STANDARD" "BRONZE" "SILVER" "GOLD" |
Responses
Response Schema: application/json
object (Casella) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "tipo_casella": "GOLD"
Response samples
- 200
- 400
- 402
- 404
- 406
- 428
- "data": {
- "tipo_casella": "GOLD",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "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",
- "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:
path Parameters
id required | string Example: 6040e4613a716838dc4eee0e Pec id |
query Parameters
anni | 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 |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": {
- "tipo_casella": "BRONZE",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "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",
- "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",
- "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 a pec box. It can only be activated on STANDARD, BRONZE, SILVER and GOLD mailboxes.
Authorizations:
path Parameters
id required | string Example: 6040e4613a716838dc4eee0e Pec id |
Request Body schema: application/json
nome required | string name of the user |
cognome required | string surname of the user |
descrizione required | string description |
email_gestione_password required | string email of the user |
Responses
Response Schema: application/json
object (Casella) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "nome": "luca",
- "cognome": "bianchi",
- "descrizione": "prima utenza",
- "email_gestione_password": "[email protected]"
Response samples
- 200
- 400
- 402
- 404
- 406
- 428
- "data": {
- "tipo_casella": "BRONZE",
- "tipo_cliente": "PV",
- "sottotipo_cliente": "",
- "sottotipo_cliente_altro": "",
- "nome_richiedente": "mario",
- "cognome_richiedente": "rossi",
- "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": {
- "field": "data",
- "method": "POST",
- "data": { }
- "dominio": "testcert.legalmail.it",
- "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",
- "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",
- "id_utenza": "6040e4613a716838dc4eee0e_0",
- "timestamp": {
- "attivazione": 1614868138
- "userid": "MA177993"
- "id": "6040e4613a716838dc4eee0e",
- "autorinnovo": false
- "success": true,
- "message": "",
- "error": null
List of your communications
This method shows you all the certified e-mail communications to the business register started
Authorizations:
Responses
Response Schema: application/json
Array of objects (RichiesteComunicazionePec) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": [
- {
- "id": "60ad149c3a7168084f1d2b68",
- "stato": "comunicazione_evasa",
- "timestamp": 1622127248,
- "owner": "[email protected]"
- {
- "id": "60ad0f2a3a716801f42a9773",
- "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:
Request Body schema: application/json
casella_pec required | string certified e-mail box to communicate |
cf required | string tax code of the applicant |
nome required | string name of the applicant |
cognome required | string surname of the applicant |
qualifica required | string Enum: "AMMINISTRATORE" "COMMISSARIO_GIUDIZIARIO" "CURATORE_FALLIMENTARE" "LEGALE_RAPPRESENTANTE" "LIQUIDATORE" "SOCIO" "TITOLARE" qualification of the applicant |
email required | string email of the owner |
cellulare required | string mobile phone of the owner |
ragione_sociale required | string business name |
cf_piva required | string tax code or VAT number |
comune required | string municipality of the company |
provincia required | string province of the company |
object (Callback) |
Responses
Response Schema: application/json
object (RichiestaComunicazionePec) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "cf": "RSSMRA80A01L117D",
- "nome": "mario",
- "cognome": "rossi",
- "qualifica": "LEGALE_RAPPRESENTANTE",
- "cellulare": "34xxxxxx18",
- "ragione_sociale": "azienda test",
- "cf_piva": "12345678910",
- "comune": "roma",
- "provincia": "RM"
Response samples
- 200
- 402
- 406
- 428
- "data": {
- "cf": "RSSMRA80A01L117D",
- "nome": "mario",
- "cognome": "rossi",
- "qualifica": "LEGALE_RAPPRESENTANTE",
- "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": [ ],
- "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:
path Parameters
id required | string Example: 60ad149c3a7168084f1d2b68 Comunica Pec id |
Responses
Response Schema: application/json
object (RichiestaComunicazionePec) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": {
- "cf": "RSSMRA80A01L117D",
- "nome": "mario",
- "cognome": "rossi",
- "qualifica": "LEGALE_RAPPRESENTANTE",
- "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"
- "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:
path Parameters
id required | 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 |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "documenti": "JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"
Response samples
- 200
- 400
- 404
- 406
- 428
- "data": {
- "cf": "RSSMRA80A01L117D",
- "nome": "mario",
- "cognome": "rossi",
- "qualifica": "LEGALE_RAPPRESENTANTE",
- "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"
- "timestamp": 1625067055,
- "id": "60dc8da86c8b04624536bbb2"
- "success": true,
- "message": "",
- "error": null
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:
path Parameters
id required | string Example: 5f7b2e323a716857774a4373 request id |
Responses
Response Schema: application/pdf
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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);
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:
path Parameters
id required | string Example: 5f7b2e323a716857774a4373 request id |
Responses
Response Schema: application/pdf
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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);
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:
path Parameters
id required | string Example: 5f7b2e323a716857774a4373 request id |
Responses
Response Schema: application/pdf
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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);