Taxes & Fees API
Calculate all applicable taxes and fees for vehicle sales based on VIN, location, and transaction details
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.
Endpoint
GET https://api.auto.dev/taxes/{vin}Parameters
Path Parameters
| Prop | Type | Default |
|---|---|---|
vin | string | - |
Query Parameters
| Prop | Type | Default |
|---|---|---|
zip? | number | - |
creditScore? | number | - |
styleId? | string | - |
listingId? | string | - |
price? | number | - |
miles? | number | - |
Example Request
curl -X GET "https://api.auto.dev/taxes/WP0AF2A99KS165242?zip=33132&price=239888&miles=10616" \
-H "Authorization: Bearer YOUR_API_KEY"Response Structure
Example Response
{
"vehicle": {
"vin": "WP0AF2A99KS165242",
"year": "2019",
"make": "Porsche",
"model": "911"
},
"criteria": {
"price": 25000,
"zip": "33132",
"docFee": 200,
"tradeIn": "15000"
},
"totalTaxesAndFees": 1260.75,
"taxes": {
"citySalesTax": 0,
"combinedSalesTax": 700,
"countySalesTax": 100,
"districtSalesTax": 0,
"stateSalesTax": 600,
"gasGuzzlerTax": 0
},
"fees": {
"titleFee": 85.25,
"registrationFee": 247.5,
"dmvFee": 28,
"combinedFees": 560.75,
"docFee": 200,
"dmvFees": {
"License Plate Fee": 28
}
}
}Use Cases
- Dealership Sales Calculator: Build accurate "out-the-door" pricing for customers including all taxes and fees
- Multi-State Comparison: Compare total registration costs across different states for purchase optimization
- Financing Integration: Calculate accurate amounts to finance including all applicable taxes and fees
Error Responses
Invalid Request
{
"status": 400,
"error": "Oops! Something went wrong while fetching your taxes.",
"code": "INVALID_REQUEST",
"path": "/taxes/WP0AF2A99KS165242?zip=12345",
"requestId": "b2c3d4e5f6g7h8i9",
"suggestion": "Please check zip code: 12345"
}Invalid VIN
{
"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"
}VIN Not Found
{
"status": 404,
"error": "No vehicle data found for the provided VIN",
"code": "VIN_NOT_FOUND",
"path": "/taxes/WP0AF2A99KS165242",
"requestId": "c3d4e5f6g7h8i9j0"
}Plan Availability
- Starter: ❌ Not available
- Growth: ❌ Not available
- Scale: ✅ Available
See pricing for plan details and signup.
Was this API reference helpful?