Lookup Tariff Codes
home
Introduction
Recent changes in customs and clearance procedures in various countries have necessitated the use of Harmonized System (HS) tariff codes for cross-border shipments.
lookup-tariff-codes API Overview
As of March 2023, Harmonised System (HS) tariff codes became mandatory for all international shipments.
The aim of this lookup-tariff-codes API is to help NZ Post customers easily identify the HS tariff code based on the contents description information, or obtain the full goods description based off of the HS tariff code.
The API allows you to get HS codes and corresponding full and accurate descriptions for your international shipments which will enhance customs clearance efficiency and prevent delays by accurately classifying your products.
lookup-tariff-codes includes the following resources.
Resource Information
| End point Name | Function | Resource URL | Verb |
|---|---|---|---|
| Classify | Returns 6 digit or country-specific (8+ digit) HS codes for your shipments or Validate Pre-existing HS Codes. | UAT: https://api.uat.nzpost.co.nz/lookup-tariff-codes/v1/classify/*
PROD: https://api.nzpost.co.nz/lookup-tariff-codes/v1/classify/* Note: Please refer to the [Classify][1] page for more information about classify features. |
POST |
| Lookup Tariff Codes for EAD Portal User | Returns HS codes (6 digit or 10 digit) required for the EAD Portal requirements. | UAT: https://api.uat.nzpost.co.nz/lookup-tariff-codes/v1/fetch-codes/ead/{records}?destination_country=%destination_country%
PROD: https://api.nzpost.co.nz/lookup-tariff-codes/v1/fetch-codes/ead/{records}?destination_country=%destination_country% |
POST |
| Attribute | Detail |
|---|---|
| Response Format | JSON |
| Requires Authentication | Yes |
Prerequisites
- Your organisation must have an active NZ Post account number/TPID. 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. Please refer to Getting Started for more information.
- 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.