ImportOS · Документація
Довідник API

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.

  • Автентифікація: заголовок Authorization: Bearer rv_live_... (API-ключі та scopes)
  • Потрібний scope: read:pricing
Опис операції, параметрів і полів походить зі специфікації OpenAPI (openapi.json) і подається англійською, як у самому API.

Тіло запиту

ПолеТипОбов’язк.Опис
lot_pricenumberтак
lot_currency"USD"ні
auction"copart" | "iaai" | "manheim" | "other"так
bid_channel"online" | "prebid" | "onsite"ні
auction_termsobjectні
auction_terms.title"clean" | "non_clean"ні
auction_terms.payment"secured" | "unsecured"ні
vehicleobjectтак
vehicle.vinstringні
vehicle.makestringні
vehicle.modelstringні
vehicle.yearintegerтак
vehicle.fuel"petrol" | "diesel" | "hybrid" | "phev" | "ev" | "lpg" | "cng" | "hydrogen" | "other"так
vehicle.engine_ccintegerні
vehicle.kwhnumberні
vehicle.body"sedan" | "hatchback" | "wagon" | "suv" | "crossover" | "coupe" | "convertible" | "minivan" | "van" | "pickup" | "truck" | "motorcycle" | "other"ні
vehicle.usOriginbooleanні
vehicle.damagestringні
vehicle.co2_g_kmnumberні
vehicle.right_hand_drivebooleanні
vehicle.mileage_kmnumberні
vehicle.mass_kgnumberні
vehicle.power_kwnumberні
vehicle.gearbox"manual" | "automatic"ні
fromobjectні
from.auction_yardstringні
from.zipstringні
from.statestringні
from.countrystringні
from.port"USEWR" | "USSAV" | "USJAX" | "USHOU" | "USLAX" | "USSEA" | "USCHI"ні
toobjectтак
to.country"UA" | "PL" | "LT" | "GE" | "DE"так
to.citystringні
to.port"LTKLJ" | "PLGDN" | "ROCND" | "GEPTI" | "DEBRV"ні
fee_modelobject | objectні
fee_model.model"fixed" | "percent"ні
fee_model.amountnumberні
fee_model.currencystringні
fee_model.pctnumberні
fee_model.minnumberні
optionsobjectні
options.insurance"none" | "basic" | "full"ні
options.certificationbooleanні
options.delivery_ua_citystringні
options.delivery_citystringні
options.shipping_mode"container" | "roro"ні
options.repairbooleanні
options.registrationbooleanні
options.usOriginZeroDutyboolean | "auto"ні
target_currencystringні
datestringтак
locale"uk" | "pl" | "en"ні

Відповіді

200

Landed cost breakdown.

application/json · Схема: LandedCostResponse

ПолеТипОбов’язк.Опис
country"UA" | "PL" | "LT" | "GE" | "DE"так
currencystringтак
itemsobject[]так
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"ні
items[].codestringні
items[].amountnumberні
items[].currencystringні
items[].amountInTargetnumberні
items[].explanationstringні
items[].explanationKeystringні
items[].explanationParamsobjectні
items[].formulastringні
items[].sourceobject[]ні
items[].verifiedbooleanні
items[].typicalbooleanні
items[].rangeobjectні
totalnumberтак
total_rangeobjectтак
total_range.minnumberтак
total_range.maxnumberтак
by_currencyobjectтак
customs_valueobjectтак
customs_value.amountnumberтак
customs_value.currencystringтак
customs_value.componentsstring[]так
assumptionsobject[]так
assumptions[].codestringні
assumptions[].messagestringні
assumptions[].paramsobjectні
warningsobject[]так
warnings[].codestringні
warnings[].messagestringні
warnings[].paramsobjectні
rulesVersionstringтак
rulesUsedobject[]так
rulesUsed[].idstringні
rulesUsed[].verifiedbooleanні
rulesUsed[].effectiveFromstring | nullні
rulesUsed[].checkedAtstringні
rulesUsed[].sourcesobject[]ні
rulesUsed[].notestringні
fxobject[]так
fx[].pairstringні
fx[].ratenumberні
fx[].datestringні
fx[].modestringні
confidencenumberтак
inputanyні

400

Invalid request parameters or body (code validation_error).

application/problem+json · Схема: Problem

401

Missing, malformed, unknown, revoked or expired API key (code unauthorized).

application/problem+json · Схема: Problem

403

The API key lacks the scope required by this endpoint (code insufficient_scope).

application/problem+json · Схема: Problem

422

Input is syntactically valid but cannot be calculated (e.g. no rules for the date).

application/problem+json · Схема: Problem

429

Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.

application/problem+json · Схема: Problem

502

FX provider unavailable.

application/problem+json · Схема: Problem

Приклад

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"
}'

GET /v1/fx

Exchange rate

GET /v1/market-price

Market price estimate (p25 / median / p75) from listings

На цій сторінці

Тіло запитуВідповіді200400401403422429502Приклад