Skip to main content
POST
Compare landed cost across up to 6 origin countries.

Authorizations

Authorization
string
header
required

API key issued from the LandedFees dashboard under Settings > API keys. Format: sk_live_... (production) or sk_test_... (sandbox). Pass in the Authorization: Bearer <key> header.

Headers

Idempotency-Key
string

Client-generated unique string (recommended UUID v4). Repeating the same key within 24 hours returns the cached response for the original request body. Different bodies with the same key return HTTP 409.

Required string length: 8 - 128
Example:

"e4c1d2a0-8f6b-4c9d-a123-2f8b7c5e9d10"

Body

application/json
hs_code
string
required
Minimum string length: 6
Example:

"8518.30.20"

destination
string
required
Required string length: 2
Example:

"US"

value
number
required
origins
string[]
required
Required array length: 1 - 6 elements
Required string length: 2
currency
string
default:USD
Required string length: 3
freight
number
default:0
Required range: x >= 0
insurance
number
default:0
Required range: x >= 0
incoterm
enum<string>
default:FOB
Available options:
EXW,
FCA,
CPT,
CIP,
DAP,
DPU,
DDP,
FAS,
FOB,
CFR,
CIF
transport_mode
enum<string>
default:ocean
Available options:
ocean,
air,
truck,
rail,
express
eu_member_state
string
Required string length: 2
br_state
string
Required string length: 2
ca_province
string
Required string length: 2
calculation_date
string<date>

Response

Comparison completed.

hs_code
string
destination
string
currency
string
value
number
incoterm
string
transport_mode
string
freight
number
insurance
number
origins_requested
string[]
results
object[]
calculated_at
string<date-time>