LandedHub Programmatic Integration
Integrate real-time SARS automated apparel duties, import tax compounding structures, and calculated landed cost metrics directly into your customs processing workflows, custom checkout configurations, or enterprise ERP endpoints.
🔑 Authentication
All API calls targeting production routes must authenticate credentials cleanly. Pass your active license string as a payload variable directly within the secure network transfer layer.
Payload Property Key: apiKey Required
🚀 Core Core Endpoint Mappings
POST /api/calculate
Calculate South African customs duty, VAT, and landed cost for apparel imports using the latest supported HS codes.
Request Structure Parameters
| Field Attribute | Data Type | Definition Context |
|---|---|---|
| apiKey | string | Your production active license verification sequence token string. |
| customsValueZAR | number | The base Free-On-Board value modeling line item cost structure totals. |
| hsCode | string | Unified target international system tariff code reference points. |
| originCountry | string | (Optional) The geographic source trade route. Defaults to "INTL" for standard global tariffs. Set to "SACU" to automatically apply regional trade union agreement exemptions (0% customs duty rate). |
💰 API Subscription Access Models
Scale calculation volumes seamlessly via our proxy connection layer. Choose a volume milestone that accurately represents your integration requirements.
Free / Sandbox
Dev Tier$0 / mo
- • 50 to 100 calculations per month
- • Testing endpoints enabled
- • Comprehensive parameters map
Growth Tier
Startup$28 / mo
- • Up to 2,500 requests / mo
- • Automated priority processing
- • Developer email ticketing
Popular
Pro / Scale
Production$74 / mo
- • Up to 10,000 requests / mo
- • Higher concurrency rate-caps
- • Premium response speeds
Enterprise
VolumeCustom Pricing
- • Tailored high-volume allocations
- • Dedicated system isolation
- • Enterprise level SLA commitments
cURL Example bash
curl -X POST "https://www.landedhub.co.za/api/calculate" \
-H "Content-Type: application/json" \
-d '{
"apiKey": "YOUR_COMMERCIAL_KEY",
"customsValueZAR": 5000,
"hsCode": "6109.10.10",
"originCountry": "INTL"
}' JavaScript Example javascript
const fetchLandedCosts = async () => {
const payload = {
apiKey: "YOUR_COMMERCIAL_KEY",
customsValueZAR: 5000,
hsCode: "6109.10.10",
originCountry: "INTL"
};
try {
const res = await fetch('https://www.landedhub.co.za/api/calculate', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
const json = await res.json();
console.log("Total ZAR Landed:", json.data.totalLandedCostZAR);
} catch (err) {
console.error("LandedHub API link drop:", err);
}
}; Return Standard Payload Signature json
{
"success": true,
"meta": {
"hsCode": "6109.10.10",
"category": "Knit T-Shirts (Collarless)",
"appliedDutyRate": "45%"
},
"data": {
"customsDutyZAR": 2250,
"vatBaseZAR": 7750,
"importVatZAR": 1162.5,
"totalLandedCostZAR": 8412.5
}
}
Backend Integration (Python Requests) python
import requests
url = "https://www.landedhub.co.za/api/calculate"
payload = {
"apiKey": "YOUR_COMMERCIAL_KEY",
"customsValueZAR": 5000,
"hsCode": "6109.10.10",
"originCountry": "INTL"
}
try:
response = requests.post(url, json=payload)
data = response.json()
print("Total Landed Cost ZAR:", data["data"]["totalLandedCostZAR"])
except Exception as e:
print("LandedHub API Connection Error:", e) WooCommerce Example (PHP cURL) php
$ch = curl_init("https://www.landedhub.co.za/api/calculate");
$payload = json_encode([
"apiKey" => "YOUR_COMMERCIAL_KEY",
"customsValueZAR" => 5000,
"hsCode" => "6109.10.10",
"originCountry": "INTL"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$response = curl_exec($ch);
if (!curl_errno($ch)) {
$result = json_decode($response, true);
error_log("Landed Cost: " . $result['data']['totalLandedCostZAR']);
}
curl_close($ch);