Our prices
Price list for single API calls
- International Registered Mail € 7,50 + vat
International Registered Mail
- Home
- Postal Services
- International Registered Mail
-
starting from € 7,50 + vat
Poste Italiane's service for sending abroad in a tracked manner
International Registered Mail is the service for sending to any country in the world, trackable, in a few seconds. The service is available 24/7.
The International Registered Mail service allows you to send any type of document (letter, invoice, etc.) to any country in the world in just a few seconds and with tracking system. All via API.
You can send registered mail through the API to one or more recipients (no limits) whether private individuals or companies, to standard addresses or PO boxes, all with a single submission.
The number of pages for international registered mail can be between 1 and 100. Beyond 50 pages, the front/back function must necessarily be set.
The prices listed only pertain to the most commonly used price ranges. When sending using the POST /raccomandate/ endpoint, it is possible to get, before charging, the cost of each shipment, which is calculated based on the number of pages, the selected options, and the destination country. Destination countries are grouped into 3 zones:
- Zone 1: EUROPE AND MEDITERRANEAN BASIN
- Zone 2: OTHER AFRICAN COUNTRIES, AMERICAS, OTHER ASIAN COUNTRIES
- Zone 3: OCEANIA
INTERNATIONAL REGISTERED MAIL
INTERNATIONAL REGISTERED MAIL REQUEST
POST /raccomandate/
To send an International Registered Mail, use the same endpoint as the Italian service POST /raccomandate/ and provide the following information:
- sender's name and address
- recipient's name and address
- text or attachment of the document (url, html, plain text)
{
"mittente": {
"titolo": "mr",
"nome": "string",
"cognome": "string",
"dug": "string",
"indirizzo": "string",
"civico": "string",
"comune": "string",
"cap": "string",
"provincia": "string",
"nazione": "string",
},
"destinatari": [
- {
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"civico": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
},
],
- "documento": [
"Testo"
],
- "opzioni": {
"fronteretro": false,
"colori": false,
"autoconfirm": false,}
}
When making the request, you can also select a series of options:
- Double-sided printing
- Colors
- Schedule sending (timestamp_invio)
- Sending receipt
In this case, the data required for the recipient are partially different; the "dug" fields (e.g., boulevard) and house number should be entered directly into the address field, and the province will always be "ee".
It is also possible to set the automatic confirmation (autoconfirm) to automatically send the shipment (if the value is "true"). In this case, the shipping cost will be charged immediately, and the sending will be scheduled.
If, however, you want to verify the shipment details and associated costs before sending, autoconfirm should be set to false. In the POST request response, you will have access to a series of information such as ID (needed for shipping confirmation) and shipping costs.
INTERNATIONAL REGISTERED MAIL RESPONSE
POST /raccomandate/
The response will include all information about the sender, recipient, and message, as well as detailed information about the costs.
{
"mittente": {
"nome": "string",
"cognome": "string",
"dug": "string",
"indirizzo": "string",
"civico": "string",
"comune": "string",
"cap": "string",
"provincia": "string",
"nazione": "string",
},
"destinatari": [
- {
"nome": "string",
"cognome": "string",
"dug": "string",
"indirizzo": "string",
"civico": "string",
"comune": "string",
"cap": "string",
"provincia": "string",
"nazione": "string",
},
],
- "documento": [
"Text"
],
- "opzioni": {
"fronteretro": false,
"colori": false,
"autoconfirm": false,
"ar": true,
"timestamp_invio": 1627649809,
},
"prodotto": "international registered mail",
"creation_timestamp": 1627649809,
"update_timestamp": 1627649810,
"username": "[email protected]",
"confirmed": true,
"state": "CONFIRMED",
"documento_validato": {
"pdf": "https://ws.ufficiopostale.com/Up/pdf/f7294e76871965ea206d560d77ff079e.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/f7294e76871965ea206d560d77ff079e.jpg",
"pagine": 1,
"size": 9350
},
"pricing": {
"dettaglio": [
{
"codice_servizio": "ReturnReceipt",
"descrizione_servizio": "Return Receipt",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0.8,
"importo_unitario_netto": 0.8,
"importo_unitario_iva": 0
},
{
"codice_servizio": "pages",
"descrizione_servizio": "Postal Rate Pages",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 3.4,
"importo_unitario_netto": 3.4,
"importo_unitario_iva": 0
},
{
"codice_servizio": "PRINT",
"descrizione_servizio": "Print Cost",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0.1,
"importo_unitario_netto": 0.1,
"importo_unitario_iva": 0
},
{
"codice_servizio": "ENVELOPE",
"descrizione_servizio": "Envelope",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {
"importo_totale_netto": 8.6,
"importo_totale_iva": 0,
"importo_totale": 8.6
}
},
"lock": false,
"confirmed_timestamp": 1627649810,
"id": "6103f712dd2507415c5db6d0"
}
],
SENDING CONFIRMATION
PATCH /raccomandate/
To confirm the sending of the International Registered Mail, you need to make a second request using the PATCH method and pass the ID of the previously made request.
The response will include all the data of the International Registered Mail with the status "confirmed".
Due to the differences in objectives between countries, Poste Italiane cannot set a quality goal for delivery times to foreign countries.
NOTE: The prices at the time of purchase via API are further detailed between postal rate, printing, and envelope. The tracking code is provided synchronously within a few seconds of the sending confirmation.