ParcelLabel API
home
Introduction
The ParcelLabel API is used to create parcel and destination specific shipping labels for domestic or international services.
You may apply to use a logo for your company to be incorporated onto your Courier and Express shipping labels. Provided logos can be sent to techsupport@nzpost.co.nz and must be 1480 pixels wide by 380 pixels high in png format. Upon confirmation of receipt and acceptance of the label size and format, you will be provided with a logo id. Courier and Express label requests that include a valid logo id will be created with the logo in place.
ParcelLabel includes the following resources:
| Name | Function | Verb |
|---|---|---|
| Create Label(s) - Domestic | Request for creating one or multiple domestic labels. | POST |
| Create Label(s) - International | Request for creating one or multiple international labels. | POST |
| Create Labels(s) – International (Offshore) | This is a request for creating one or multiple domestic labels for an offshore customer. | POST |
| Get Status of Label(s) | Get the status of all labels within a consignment. | GET |
| Get Status of Related Label(s) | Get the status of all labels within a consignment and the related consignments within an order. | GET |
| Download Label(s) | Download all labels within a consignment in PDF format, or a specific label in PNG format. | GET |
| Download Label(s) Direct | Download all labels within a consignment in PDF format. The direct method allows you to enter your client id and client secret in the parameter of the HTTP request URL. | GET |
| Manifest Only option | Submit manifest to NZ Post by including the manifest_only flag and a tracking_number in your request payload. A label will not be generated. | POST |
Please refer to the RAML to see field types, length and other restrictions.
The process diagram below shows a basic overview of how ParcelLabel API can work for an organisation using the polling method.
Pre-requisites
- Your organisation must have an active NZ Post account number. The account number starts with a 9 or 5.If you do not have an account number, then you can call 0800 COURIER.
- You must have an online New Zealand Post account. You can register here by completing the registration form. The email address you provide on the registration form will be your Developer Portal username.
- You must have reviewed and accepted the Terms and Conditions for use of the NZ Post Group APIs.
- You must have requested and received access to the API.
Support
For developer integration enquiries, please email techsupport@nzpost.co.nz. Support is available during New Zealand business hours.