Our prices
Price list for single API calls
- International Postamail via API € 1,30 + vat
International Postamail via API
- Home
- Postal Services
- International Postamail via API
-
starting from € 1,30 + vat
Poste Italiane's service for sending ordinary mail abroad
International Postamail is the standard mail service for sending letters, documents, and communications to any country in the world in just a few seconds. The service is available 24/7.
The Postamail International service allows you to send low-cost communications to all countries in the world with delivery in 8 days. All via API.
With International Postamail, you can send letters and documents to one or more recipients (no limits), both private and business, all with a single call:
REQUEST EXAMPLE
POST /ordinarie/
To send international postamail, you need to use the same endpoint as the Post 4 service POST /ordinarie/ and provide information such as:
- sender's name and address
- recipient's name and address
- text
{
"data": {
"sender": {
"company": "openapi spa",
"street": "piazza",
"address": "cavour",
"house_number": "43",
"city": "roma",
"postal_code": "00121",
"region": "rm",
"email": "[email protected]",
"country": "IT"
},
"recipients": [
{
"first_name": "string",
"last_name": "string",
"address": "string",
"city": "string",
"postal_code": "string",
"region": "ee",
"country": "string",
"id": "664228bbbf1239901b0815f2",
"status": "NEW"
}
],
- "document": [
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX"
],
- "options": {
"double_sided": false,
"color": false,
"auto_confirm": false,
"receipt": false
}
}
}
In this case, the required data for the recipient is partially different: the street (e.g. viale) and house number fields should be entered directly in the address field, and the region will always be "ee".
During the request, you can also select from a series of options:
- color printing
- schedule sending (timestamp_sending)
- sending receipt
- double-sided
It is also possible to set auto-confirmation ("autoconfirm") to automatically send the shipment (if the value is set to "true"). In this case, the shipping cost will be immediately charged and the shipment will be scheduled.
However, if you wish to review the shipping data and associated costs before sending, "autoconfirm" should be set to "false".
RESPONSE EXAMPLE
POST /ordinary/
The response will include all the information about the sender, the recipient, and the message, as well as detailed information about the costs and the ID needed for shipment confirmation.
{
"data": {
"mittente": {
"ragione sociale": "openapi spa",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"email": "[email protected]",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
"id": "664228bbbf1239901b0815f2",
"state": "NEW"
}
],
- "documento":
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX",
"opzioni": {
"fronte/retro": false,
"colori": false,
"autoconfirm": false,
"ricevuta": false
},
"prodotto": "regular international",,
"creation_timestamp": 1627659712,
"update_timestamp": 1627659712,
"username": "[email protected]",,
"confirmed": true,,
"state": "CONFIRMED",
"documento_validato": {
"pdf": "https://ws.ufficiopostale.com/Up/pdf/test-document.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/test-document.jpg",
"parole": 1,
"txt": "L",
"size": 1
},
"pricing": {
"dettaglio": [
{
"codice_servizio": "pages",
"descrizione_servizio": "Postal pages rate",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 4.27,
"importo_unitario_netto": 3.5,
"importo_unitario_iva": 0.77
},
{
"codice_servizio": "PRINT",
"descrizione_servizio": "Print cost",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
},
{
"codice_servizio": "ENVELOPING",
"descrizione_servizio": "Enveloping",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {
"importo_totale_netto": 7,
"importo_totale_iva": 1.54,
"importo_totale": 8.54
},
"confirmed_timestamp": 1724754216,
"id": "66cda9285673a1b85f092f03"
}
],
"success": true,
"message": "",
"error": null
}SENDING CONFIRMATION
PATCH /ordinary/
To confirm the sending of the international ordinary mail, a second request must be made using the PATCH method and passing the ID of the previously made request.
The response will include all the data of the international ordinary mail with the status "confirmed"
The delivery times for International Postamail shipments are:
- Europe: delivery in 85% of cases within 8 working days (excluding Saturdays and holidays) beyond the day of shipping
- Mediterranean Basin: delivery in 85% of cases within 12 working days (excluding Saturdays and holidays) beyond the day of shipping
- North America and Oceania: delivery in 85% of cases within 16 working days (excluding Saturdays and holidays) beyond the day of shipping
- Rest of the World: delivery in 85% of cases within 22 working days (excluding Saturdays and holidays) beyond the day of shipping
For online shipments, the following processing times are added: printing in one working day (T+1), if the shipment is accepted by 14:00 Monday to Friday, excluding holidays.