Python SDK

pip install landedfees
# or
uv add landedfees
# or
poetry add landedfees

import os
from landedfees import LandedFeesClient

client = LandedFeesClient(api_key=os.environ["LANDEDFEES_API_KEY"])

response = client.calc({
    "destination_country": "US",
    "origin_country": "CN",
    "incoterm": "FOB",
    "transport_mode": "ocean",
    "currency": "USD",
    "freight": 250,
    "insurance": 45,
    "line_items": [{
        "description": "Wireless earbuds",
        "hs_code": "8517.62.00",
        "quantity": 500,
        "unit_value": 12.50,
        "origin_country": "CN",
        "weight_kg": 0.15,
    }],
})

print(response["result"]["total_landed_cost"], response["result"]["currency"])

client.calc(body, *, idempotency_key=None, timeout=None)
client.calc_bulk(body, *, idempotency_key=None, timeout=None)
client.classify(body, *, idempotency_key=None, timeout=None)
client.compare(body, *, idempotency_key=None, timeout=None)
client.rates(country, hs, *, origin=None, calculation_date=None, timeout=None)

LandedFeesClient(
    api_key: str,
    base_url: str = "https://www.landedfees.com",
    timeout: float = 30.0,      # seconds
    max_retries: int = 1,       # extra attempts on 429 / 5xx
    user_agent: str = "landedfees-python/0.1",
)

import uuid

key = str(uuid.uuid4())
first  = client.calc(payload, idempotency_key=key)
second = client.calc(payload, idempotency_key=key)
assert first["id"] == second["id"]

from landedfees import ApiError

try:
    client.calc(payload)
except ApiError as err:
    if err.status == 429:
        time.sleep(err.retry_after or 60)
    elif err.status == 422 and err.code == "MISSING_HS_CODE":
        # Classify first, then retry.
        pass
    else:
        raise

>>> from landedfees import LandedFeesClient
>>> help(LandedFeesClient.calc)