International Postamail
€1.79 + VAT
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 International Postamail 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"
It is also possible to fully customize the cover of the communication, for example by adding a logo, company information, or promotions. Customization can be done through the API or via the Playground, which also allows you to preview before sending.
The International Postamail includes a free 12-month digital archiving option for the content signed and digitally stamped by Poste Italiane. The legal compliance of the digital archiving certifies the content, ensuring it cannot be denied by the recipient in case of a legal dispute.
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.
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The International Postamail service is a practical and convenient solution for sending letters and documents to any country in the world, using a standard mail system via API. This service is particularly useful for businesses and professionals looking to communicate globally without complications, offering a simple way to manage international shipments.
To send an item, you need to provide some essential information, including:
- Sender’s name and address
- Recipient’s name and address
- Message text
You can customize the shipment with various options, including color printing, double-sided printing, sending receipt, and the possibility to schedule the sending for a specific date and time.
The International Postamail service is designed for a wide range of users who need to send letters, documents, or communications to recipients worldwide at affordable costs. Here are some ideal users:
- Businesses
- Professionals
- Individuals
- Non-profit organizations
- Educational sectors
Delivery times vary depending on the destination:
- Europe: about 8 working days
- Mediterranean Basin: about 12 working days
- North America and Oceania: about 16 working days
- Rest of the world: about 22 working days
The cost starts at €1.79 + VAT. The final price depends on the number of pages in the document and the additional options selected, such as delivery priority or ancillary services.
Carbon free energy for Our Cloud 
Low CO2
© 2024 Openapi SpA, a single-member company, under the direction and control of Open Holding Srl.
Viale Filippo Tommaso Marinetti 221 - 00143 Rome - Business Register: 1378273, Share Capital: €50,000.00, VAT Number: IT12485671007, Recipient Code: 'USAL8PV' - Certified Email: [email protected]
Openapi is certified in: Quality System - **UNI EN ISO 9001:2015** - Data Quality **ISO 25012:2014** - Security Management **ISO/IEC 27001:2022**
All prices are net of any VAT, stamp duty, registration fees, or other taxes that may be due. All logos listed on the portal are copyrighted and owned by their respective owners.
