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.

For the International Registered Mail service, it is also possible to fully customize the cover page of the communication, adding elements such as your company logo, information, or promotions. Customization can be done via API or through the Playground, which also provides a preview before sending.

The international registered mail service includes a free digital storage option for 12 months of the content, signed and digitally stamped by Poste Italiane. This legally compliant digital storage certifies the content, which cannot be disputed by the counterparty in the event of a legal dispute.

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.