Endpoint

Bulk landed cost

Up to 500 line-item rows per call. Rows share the ship-level fields (destination, currency, incoterm, transport, freight, insurance). Freight and insurance are prorated across rows by line value. Row-level validation errors do not fail the batch.

POST/v1/calc/bulk

Request body

destination_country

string (ISO-2)Required

Ship-level destination.

currency

string (ISO-4217)Required

Ship-level invoice currency.

incoterm

enumRequired

Ship-level incoterm.

transport_mode

enumRequired

ocean, air, truck, rail, or express.

freight

number

Total ship-level freight. Prorated across rows by (quantity * unit_value).

insurance

number

Total ship-level insurance. Prorated across rows by value.

eu_member_state

string (ISO-2)

Required when destination_country is EU.

br_state

string

Brazilian state for ICMS.

ca_province

string

Canadian province for PST/HST.

usmca_qualifying

boolean

USMCA claim (US, CA, MX).

fta_id

string

Non-USMCA FTA claim.

calculation_date

date

ISO date the batch is effective on.

rows

BulkRow[]Required

1 to 500 line items. See BulkRow schema below.

BulkRow schema

description

stringRequired

Free-text product description.

hs_code

stringRequired

HS or HTS code, 4 to 13 digits (dots allowed).

Example: 8517.62 or 851762 or 8517.62.00

quantity

numberRequired

Positive number of units.

unit_value

numberRequired

Per-unit invoice value in the ship-level currency.

origin_country

string (ISO-2)Required

Origin per row.

weight_kg

number

Per-unit weight in kg.

Response 200

id

uuid

Aggregate calculation row ID.

results

RowResult[]

Per-row outcome with line_index, hs_code, origin, duty, taxes, fees, landed_cost, de_minimis_applied, warnings.

errors

RowError[]

Per-row validation or engine errors with line_index, reason, field.

aggregate

object

total_rows, ok_rows, error_rows, total_value, total_duty, total_taxes, total_fees, total_landed, currency.

Example request

curl https://www.landedfees.com/api/v1/calc/bulk \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "destination_country": "US",
  "currency": "USD",
  "incoterm": "FOB",
  "transport_mode": "ocean",
  "freight": 1200,
  "insurance": 180,
  "rows": [
    {
      "description": "Bluetooth earbuds",
      "hs_code": "8517.62",
      "quantity": 500,
      "unit_value": 12.50,
      "origin_country": "CN"
    },
    {
      "description": "USB-C charging cable",
      "hs_code": "8544.42",
      "quantity": 1000,
      "unit_value": 1.20,
      "origin_country": "CN"
    }
  ]
}'

Endpoint

Bulk landed cost

POST/v1/calc/bulk

Request body

destination_country

string (ISO-2)Required

Ship-level destination.

currency

string (ISO-4217)Required

Ship-level invoice currency.

incoterm

enumRequired

Ship-level incoterm.

transport_mode

enumRequired

ocean, air, truck, rail, or express.

freight

number

Total ship-level freight. Prorated across rows by (quantity * unit_value).

insurance

number

Total ship-level insurance. Prorated across rows by value.

eu_member_state

string (ISO-2)

Required when destination_country is EU.

br_state

string

Brazilian state for ICMS.

ca_province

string

Canadian province for PST/HST.

usmca_qualifying

boolean

USMCA claim (US, CA, MX).

fta_id

string

Non-USMCA FTA claim.

calculation_date

date

ISO date the batch is effective on.

rows

BulkRow[]Required

1 to 500 line items. See BulkRow schema below.

BulkRow schema

description

stringRequired

Free-text product description.

hs_code

stringRequired

HS or HTS code, 4 to 13 digits (dots allowed).

Example: 8517.62 or 851762 or 8517.62.00

quantity

numberRequired

Positive number of units.

unit_value

numberRequired

Per-unit invoice value in the ship-level currency.

origin_country

string (ISO-2)Required

Origin per row.

weight_kg

number

Per-unit weight in kg.

Response 200

id

uuid

Aggregate calculation row ID.

results

RowResult[]

Per-row outcome with line_index, hs_code, origin, duty, taxes, fees, landed_cost, de_minimis_applied, warnings.

errors

RowError[]

Per-row validation or engine errors with line_index, reason, field.

aggregate

object

total_rows, ok_rows, error_rows, total_value, total_duty, total_taxes, total_fees, total_landed, currency.

Example request

curl https://www.landedfees.com/api/v1/calc/bulk \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "destination_country": "US",
  "currency": "USD",
  "incoterm": "FOB",
  "transport_mode": "ocean",
  "freight": 1200,
  "insurance": 180,
  "rows": [
    {
      "description": "Bluetooth earbuds",
      "hs_code": "8517.62",
      "quantity": 500,
      "unit_value": 12.50,
      "origin_country": "CN"
    },
    {
      "description": "USB-C charging cable",
      "hs_code": "8544.42",
      "quantity": 1000,
      "unit_value": 1.20,
      "origin_country": "CN"
    }
  ]
}'