POST /v1/landed-cost
Landed cost of a car imported from a US/EU auction
Landed cost of a car imported from a US/EU auction
Turnkey cost (auction fees, US inland, ocean freight, port, customs duty, VAT, excise, certification, registration, services) with a line-by-line explanation, formula and source for every state rate. Items with verified:false are indicative only. Tenant tariffs are used if configured, otherwise typical tariffs (warning tariffs_typical). Requires scope read:pricing.
- Authentication: header
Authorization: Bearer rv_live_...(API keys and scopes) - Required scope:
read:pricing
openapi.json).Request body
| Field | Type | Required | Description |
|---|---|---|---|
lot_price | number | yes | |
lot_currency | "USD" | no | |
auction | "copart" | "iaai" | "manheim" | "other" | yes | |
bid_channel | "online" | "prebid" | "onsite" | no | |
auction_terms | object | no | |
auction_terms.title | "clean" | "non_clean" | no | |
auction_terms.payment | "secured" | "unsecured" | no | |
vehicle | object | yes | |
vehicle.vin | string | no | |
vehicle.make | string | no | |
vehicle.model | string | no | |
vehicle.year | integer | yes | |
vehicle.fuel | "petrol" | "diesel" | "hybrid" | "phev" | "ev" | "lpg" | "cng" | "hydrogen" | "other" | yes | |
vehicle.engine_cc | integer | no | |
vehicle.kwh | number | no | |
vehicle.body | "sedan" | "hatchback" | "wagon" | "suv" | "crossover" | "coupe" | "convertible" | "minivan" | "van" | "pickup" | "truck" | "motorcycle" | "other" | no | |
vehicle.usOrigin | boolean | no | |
vehicle.damage | string | no | |
vehicle.co2_g_km | number | no | |
vehicle.right_hand_drive | boolean | no | |
vehicle.mileage_km | number | no | |
vehicle.mass_kg | number | no | |
vehicle.power_kw | number | no | |
vehicle.gearbox | "manual" | "automatic" | no | |
from | object | no | |
from.auction_yard | string | no | |
from.zip | string | no | |
from.state | string | no | |
from.country | string | no | |
from.port | "USEWR" | "USSAV" | "USJAX" | "USHOU" | "USLAX" | "USSEA" | "USCHI" | no | |
to | object | yes | |
to.country | "UA" | "PL" | "LT" | "GE" | "DE" | yes | |
to.city | string | no | |
to.port | "LTKLJ" | "PLGDN" | "ROCND" | "GEPTI" | "DEBRV" | no | |
fee_model | object | object | no | |
fee_model.model | "fixed" | "percent" | no | |
fee_model.amount | number | no | |
fee_model.currency | string | no | |
fee_model.pct | number | no | |
fee_model.min | number | no | |
options | object | no | |
options.insurance | "none" | "basic" | "full" | no | |
options.certification | boolean | no | |
options.delivery_ua_city | string | no | |
options.delivery_city | string | no | |
options.shipping_mode | "container" | "roro" | no | |
options.repair | boolean | no | |
options.registration | boolean | no | |
options.usOriginZeroDuty | boolean | "auto" | no | |
target_currency | string | no | |
date | string | yes | |
locale | "uk" | "pl" | "en" | no |
Responses
200
Landed cost breakdown.
application/json · Schema: LandedCostResponse
| Field | Type | Required | Description |
|---|---|---|---|
country | "UA" | "PL" | "LT" | "GE" | "DE" | yes | |
currency | string | yes | |
items | object[] | yes | |
items[].kind | "lot_price" | "auction_fee" | "broker_fee" | "inland_us" | "ocean" | "port" | "inland_eu" | "customs_duty" | "excise" | "vat" | "broker_customs" | "certification" | "pension_fund" | "registration" | "repair" | "detailing" | "insurance" | "our_fee" | "other" | no | |
items[].code | string | no | |
items[].amount | number | no | |
items[].currency | string | no | |
items[].amountInTarget | number | no | |
items[].explanation | string | no | |
items[].explanationKey | string | no | |
items[].explanationParams | object | no | |
items[].formula | string | no | |
items[].source | object[] | no | |
items[].verified | boolean | no | |
items[].typical | boolean | no | |
items[].range | object | no | |
total | number | yes | |
total_range | object | yes | |
total_range.min | number | yes | |
total_range.max | number | yes | |
by_currency | object | yes | |
customs_value | object | yes | |
customs_value.amount | number | yes | |
customs_value.currency | string | yes | |
customs_value.components | string[] | yes | |
assumptions | object[] | yes | |
assumptions[].code | string | no | |
assumptions[].message | string | no | |
assumptions[].params | object | no | |
warnings | object[] | yes | |
warnings[].code | string | no | |
warnings[].message | string | no | |
warnings[].params | object | no | |
rulesVersion | string | yes | |
rulesUsed | object[] | yes | |
rulesUsed[].id | string | no | |
rulesUsed[].verified | boolean | no | |
rulesUsed[].effectiveFrom | string | null | no | |
rulesUsed[].checkedAt | string | no | |
rulesUsed[].sources | object[] | no | |
rulesUsed[].note | string | no | |
fx | object[] | yes | |
fx[].pair | string | no | |
fx[].rate | number | no | |
fx[].date | string | no | |
fx[].mode | string | no | |
confidence | number | yes | |
input | any | no |
400
Invalid request parameters or body (code validation_error).
application/problem+json · Schema: Problem
401
Missing, malformed, unknown, revoked or expired API key (code unauthorized).
application/problem+json · Schema: Problem
403
The API key lacks the scope required by this endpoint (code insufficient_scope).
application/problem+json · Schema: Problem
422
Input is syntactically valid but cannot be calculated (e.g. no rules for the date).
application/problem+json · Schema: Problem
429
Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.
application/problem+json · Schema: Problem
502
FX provider unavailable.
application/problem+json · Schema: Problem
Example
curl -s -X POST "https://api.importos.app/v1/landed-cost" \
-H "Authorization: Bearer $IMPORTOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lot_price": 8000,
"auction": "copart",
"vehicle": {
"vin": "4T1B11HK5JU000001",
"year": 2018,
"fuel": "petrol",
"engine_cc": 2487,
"damage": "FRONT END"
},
"from": {
"auction_yard": "NJ - TRENTON"
},
"to": {
"country": "UA",
"city": "Київ"
},
"fee_model": {
"model": "fixed",
"amount": 700,
"currency": "USD"
},
"date": "2026-10-17"
}'