Pec (Posta Elettronica Certificata)

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

Web service that allows you to activate a certified e-mail.

First time here? Generate a new access token

Pec

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

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: prova_pec@legalmail.it

Email box

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	integer

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

Responses

Response Schema: application/json

	Array of objects (Caselle) [ items ]
success	boolean
message	string
error	integer

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");

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": "mypec@testcert.legalmail.it",
"tipo_casella": "BRONZE",
"stato": "revocata",
"data_scadenza": "04/03/2022",
"timestamp": {"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614868312,
"scadenza": 1646391493,
"revoca": 1614868400
},
"owner": "mail@domain.com"
},
{"id": "6040c9df3a716838dc4eede4",
"casella_pec": "yourpec@testcert.legalmail.it",
"tipo_casella": "STANDARD",
"stato": "evasa",
"data_scadenza": "04/03/2022",
"timestamp": {"registrazione": 1614858718,
"ultima_modifica": 1614859181,
"evasione": 1614859181,
"scadenza": 1646391493
},
"owner": "mail@domain.com"
}
],
"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>" mailbox name
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" 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" customer subtype
sottotipo_cliente_altro	string Default: "<string>" customer subtype, other
nome_richiedente required	string Default: "<string>" customer name
cognome_richiedente required	string Default: "<string>" customer surname
email required	string Default: "<string>" customer email
telefono required	string Default: "<string>" customer telephone
cellulare	string Default: "<string>" customer mobile phone
codice_fiscale_richiedente required	string Default: "<string>" customer fiscal code
data_nascita_richiedente required	string Default: "<string>" customer date of birth (accepted format: dd/mm/yyyy)
sesso_richiedente required	string Default: "<string>" Enum: "M" "F" gender
nazione_nascita_richiedente required	string Default: "<string>" customer country code
comune_nascita_richiedente	string Default: "<string>" customer city
provincia_nascita_richiedente	string Default: "<string>" customer province code
denominazione_titolare	string Default: "<string>" holder denomination
cf_piva_titolare	string Default: "<string>" holder vat number
indirizzo_titolare required	string Default: "<string>" holder address
comune_titolare required	string Default: "<string>" holder city
cap_titolare required	string Default: "<string>" holder postal code
nazione_titolare required	string Default: "<string>" holder country code
provincia_titolare required	string Default: "<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 Default: "<string>" Enum: "CARTA_D_IDENTITA" "PATENTE" "PASSAPORTO" type of identity document