Auto.dev

Calculate Taxes & Fees

Retrieve comprehensive tax and fee calculations for vehicle sales transactions. This API provides accurate, location-specific tax rates and government fees, ensuring compliance with local regulations and transparent pricing for both dealers and consumers.

GET
/taxes/{vin}
AuthorizationBearer <token>

Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

In: header

Path Parameters

vinstring

The Vehicle Identification Number

Match^[A-HJ-NPR-Z0-9]{17}$

Query Parameters

price?number

The vehicle price. Defaults to 25000 if not provided.

Default25000
Range0 <= value
zip?string

The ZIP code of the location. If not provided, defaults to user zipcode or 94020.

Default"94020"
Match^[0-9]{5}(-[0-9]{4})?$
docFee?number

Documentation fee. Defaults to 200 if not provided.

Default200
Range0 <= value
tradeIn?number

Trade-in value to deduct from taxable amount. Defaults to 0 if not provided.

Default0
Range0 <= value
rate?number

Interest rate for financing calculations. Defaults to 9.99 if not provided.

Default9.99
Range0 <= value
downPayment?number

Down payment amount. Defaults to 0 if not provided.

Default0
Range0 <= value
months?integer

Loan term in months. Defaults to 72 if not provided.

Default72
Range1 <= value

Response Body

curl -X GET "https://api.auto.dev/taxes/string?price=25000&zip=94020&docFee=200&tradeIn=0&rate=9.99&downPayment=0&months=72"

{
  "vehicle": {
    "vin": "19UDE2F31MA000428",
    "year": 2021,
    "make": "Acura",
    "model": "ILX"
  },
  "criteria": {
    "price": "85000",
    "zip": "90210",
    "docFee": 200,
    "tradeIn": 0
  },
  "totalTaxesAndFees": 9585.5,
  "taxes": {
    "citySalesTax": 637.5,
    "combinedSalesTax": 8500,
    "countySalesTax": 212.5,
    "districtSalesTax": 2550,
    "stateSalesTax": 5100,
    "gasGuzzlerTax": 0
  },
  "fees": {
    "titleFee": 23,
    "registrationFee": 65,
    "dmvFee": 797.5,
    "combinedFees": 1085.5,
    "docFee": 200,
    "dmvFees": {
      "Air Quality Fee": 6,
      "Alternative Fuel/Technology Fee": 3,
      "Auto theft deterrence/DUI fee": 2,
      "Fingerprint ID Fee": 1,
      "Highway Patrol Fee": 29,
      "Reflectorized license plate fee": 1,
      "Service Authority for Freeway Emergencies fee": 1,
      "Smog Abatement Fee": 12,
      "Transfer Fee": 15,
      "Transportation Improvement Fee": 175,
      "Vehicle License Fee": 552.5
    }
  }
}

{
  "error": {
    "status": 400,
    "error": "VIN must be exactly 17 characters containing only letters and numbers (excluding I, O, Q)",
    "code": "INVALID_VIN_FORMAT",
    "path": "/taxes/123Invalid",
    "requestId": "a1b2c3d4e5f6g7h8"
  }
}

{
  "error": {
    "status": 404,
    "error": "No vehicle data found for the provided VIN",
    "code": "VIN_NOT_FOUND",
    "path": "/taxes/WP0AF2A99KS165242",
    "requestId": "c3d4e5f6g7h8i9j0"
  }
}