TheCarApi logoTheCarApiVEHICLE DATA ENGINE
contract 2026-08-19
Endpoints

Import calculator

Estimate the landed cost of importing a vehicle. These are estimates, not a binding quote.

GET

/api/calculator/countries

List supported origin and destination countries with EU membership and VAT rates.

Requires the calculator scope.

Example requests

Request
GET https://api.thecarapi.com/api/calculator/countries
curl -H "X-API-Key: $API_KEY" "https://api.thecarapi.com/api/calculator/countries"

Example response

json
{
  "success": true,
  "countries": [
    {
      "code": "DE",
      "name": "Germany",
      "eu": true,
      "vat": 0.19
    },
    {
      "code": "KR",
      "name": "South Korea",
      "eu": false,
      "vat": 0
    }
  ]
}
POST

/api/calculator/calculate

Estimate duty, VAT, fees, and the landed total for one lot price.

Requires the calculator scope.

Parameters

pricenumber · query stringrequired

Lot price. Must be between 0 and 10,000,000.

Example 15000·Where the value comes from /api/search -> results[].public_price_eur

originstring · query string

Origin country code. Default KR.

Example KR·Where the value comes from /api/calculator/countries -> countries[].code

destinationstring · query string

Destination country code. Default BG.

Example BG·Where the value comes from /api/calculator/countries -> countries[].code

car_typestring · query string

Default standard.

Example standard·Where the value comes from Choose standard or classic.

currencystring · query string

Echoed back in the response. Default EUR.

Example EUR·Where the value comes from Currency label used by your application.

site_namestring · query string

Source used to select the fee model: encar, openlane, auto1, schadeautos, copart, or ecarstrade.

Example ecarstrade·Where the value comes from /api/sites -> sites[].name

db_tax / db_delivery / db_finalnumber · query string

Optional auction fee, delivery, or final price overrides.

Example 450·Where the value comes from Precomputed values from your own records.

Example requests

Request
POST https://api.thecarapi.com/api/calculator/calculate
{
  "price": 15000,
  "origin": "KR",
  "destination": "BG",
  "site_name": "encar"
}
POST https://api.thecarapi.com/api/calculator/calculate
{
  "price": 9800,
  "origin": "BE",
  "destination": "BG",
  "site_name": "ecarstrade"
}

Example response

json
{
  "success": true,
  "currency": "EUR",
  "breakdown": {
    "lot_price": 15000,
    "auction_fee": 0,
    "trucking": 0,
    "shipping": 1800,
    "our_fee": 700,
    "subtotal_customs_value": 16800,
    "duty_rate": 10,
    "duty_amount": 1680,
    "vat_rate": 20,
    "vat_amount": 3696,
    "customs_agency": 800,
    "custom_clearance_total": 6176,
    "estimated_total": 23676
  }
}