Shipping APIs

We have developed six shipping solutions to make it easy for you to ship parcels to your customers using services across NZ Post. These solutions are in the form of APIs for easy integration with your website.

Parcel Address API

You can make your customer's checkout process easier with Parcel Address API. This allows for ‘type-ahead’ addressing functionality within your website for New Zealand or international customers to improve delivery performance.

The ParcelAddress API database is continuously updated so that you and your customers have access to New Zealand’s most comprehensive list of addresses. Parcel Address API also identifies NZ rural addresses, ensuring that the correct delivery services can be displayed. For your added convenience, international addressing is also available within this API, powered by Google Places. See the terms of use for Google PlacesOpens in a new window. .

Read our technical documentation

Shipping Options API

Give your customers choice and control of shipping options by integrating this functionality into your shopping cart.

Using valid address and package details you provide, the Shipping Options API will display NZ Post parcel services enabled on your account to the chosen destination address. These options include identifying rural delivery and the add-ons available, such as evening delivery and signature required. As the merchant, you control which options and rates are displayed within your customer’s shopping cart.

More shipping options are being developed and these will be available to you online automatically, giving you and your customers maximum shipping flexibility.

Read our technical documentation

Parcel Label API

Parcel Label API connects our parcel labelling functions with your warehousing and eCommerce systems. This enables you to quickly produce pre-printed labels to ensure delivery accuracy and speed, and scale it quickly as you grow.

Parcel Label API's rich functionality includes label creation for domestic, urgent and international parcel services and can include optional information such as rural delivery and signature required.

Parcel Label API can be implemented in conjunction with Parcel Address API and Shipping Options API, or independently, depending on your business’ needs.

Labels are provided in PDF format and can be printed from most commercially available printers. As charges are only applied when the label is scanned by one of our couriers, you won’t be charged for labels that are printed in error and discarded before being applied to the parcel.

Read our technical documentation

Parcel Pickup API

Parcel Pickup API allows for scheduling of pick-up services, so you can respond to urgent customer orders and tailor pick-up frequency to your business needs.

Read our technical documentation

Parcel Track API

Parcel Track API integrates tracking events for domestic and international deliveries into your own ecommerce system based on network scan events. By displaying tracking on your website you can create upselling opportunities, as well as potentially reducing calls to your call centre. An extra benefit is that you can use this information to track and benchmark delivery efficiency.

Parcel Track API can be used to retrieve the shipping history of an NZ Post parcel, based on network scan events, which can be displayed seamlessly with the look and feel of your website for use by your customers as well as your support team.

Read our technical documentation

Collect my Parcel

The Collect my Parcel functionality provides the data so you can display the nearest collection points to your customer’s delivery address and produce a Collection Label for your parcels.

Collection Address

For a given address ID, address details are returned with a detailed list of nearby collection points

Collect my Parcel Label

Creates a domestic label. If a collection point location ID is provided in the request, the label produced will be a Collection label and the mandatory customer notification subscription will be created.