Duty Tax Calculator API
home
Introduction:
The ‘LandedCost’ endpoint in the Postal DDP API enables developers to retrieve accurate landed cost estimates for international shipment in real time. This includes all appliable duties, taxes, and fees based on shipment details such as destination, item classification, and declared value.
By integrating this API, your application can provide end users with full cost transparency at checkout or during shipment planning – reducing surprises at delivery and helping to ensure compliance with international customs regulations.
This API is designed for seamless integration into your applications that require accurate cross-border cost calculations.
Overview:
The ‘/LandedCost’ endpoint takes the input parameters provided in your request - such as origin and destination countries, item details (including HS codes), and declared values and returns a detailed breakdown of the estimated landed cost.
Key Features:
- Real-time landed cost calculation for international shipments
- Support for multi-item shipments
- Customs-compliant tariff and tax estimation based on product classification
- Granular cost breakdown for transparency
- Designed for integration into your process flows
This documentation provides the necessary endpoints, request/response structures, authentication methods, and usage examples to help you get started quickly.
Postal DDP API includes the following resources:
Resource Information:
| Endpoint Name | Function | Resource URL | Verb |
|---|---|---|---|
| LandedCost | Returns a detailed breakdown of all applicable duties, taxes, and fees for an international shipment based on shipment's origin, destination, and item details. | UAT: https://api.uat.nzpost.co.nz/postalddp/v1/landedcost PROD: https://api.nzpost.co.nz/postalddp/v1/landedcost |
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.