Site Logo

An Post Guide

An Post offers domestic and international shipping solutions for shipments originating in Ireland. As the national postal service provider of Ireland, An Post is responsible for delivering mail and parcels across the country and operating post offices throughout its network.

This guide provides developers an overview of shipping services that An Post offers and the service codes that you will use to create An Post shipments.

Connect Your Account

ShipEngine API allows you to connect your An Post accounts programmatically without logging in to the ShipEngine API dashboard. This is useful if you have wrapped a custom UI around the ShipEngine API toolset and want to add or disconnect existing carrier accounts without exposing your end users to the API dashboard.

These APIs can be used in parallel with the ShipEngine Partner APIs to programmatically create new ShipEngine users, and then connect existing An Post accounts all via the API without logging into a dashboard. Together these APIs empower you to completely white-label the ShipEngine experience for your end users.

Continue below for instructions on how to programatically connect An Post using the ShipEngine API.

For instructions on connecting An Post via the ShipEngine dashboard, go to our An Post help article.

An Post Account Information Model

PropertyDescriptionType
customer_account_numberAccount numberstring_, required
sftp_hostSFTP Hoststring, required
sftp_usernameSFTP Usernamestring, required
sftp_passwordSFTP Passwordstring, required
sftp_locationSFTP Locationstring, required
sequence_package_tracking_number_range_fromPackage tracking number range first numbernumber, required
sequence_package_tracking_number_range_toPackage tracking number range last numbernumber, required

Example POST Call

POST /v1/connections/carriers/An Post

1
2
3
4
5
6
7
8
9
10
11
12
POST /v1/connections/carriers/An Post HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"nickname": "My An Post Account"
"account_number": "123456789",
"company": "Example Corp.",
"first_name": "John",
"last_name": "Doe",
}
1
2
3
{
"carrier-id": "se-1234567"
}

An Post Service Details

ServiceCarrier CodeService API Codes
Express With Signature ParcelEXPan_post_express_with_signature_parcel
Express With Signature PacketSWPan_post_express_with_signature_packet

Packages

NameAPI CodePackage Attributes
Parcelan_post_parcelDomestic
Packetan_post_packetDomestic

Return Services

Return services are not supported for this carrier.

Adding Shipment Insurance

Adding shipment insurance is not supported for this carrier.

Additional Information

End of Day manifests are required for An Post. They are sent electronically to the SFTP location set up by merchants during connection.

You are now ready to create shipments using An Post via ShipEngine!