API Documentation

Overview

AssetDropper provides a free REST API for vehicle depreciation calculations. Perfect for developers building automotive tools, car buying guides, or financial planning apps.

Rate Limits

100 requests per day per IP address
No authentication required
Rate limit resets at midnight UTC

Endpoints

POST /api/depreciate

Calculate vehicle depreciation based on purchase year, price, and vehicle type.

Request Body

{
  "purchaseYear": 2020,
  "purchasePrice": 25000,
  "vehicleType": "sedan",
  "currentMileage": 50000
}

Parameters

Field	Type	Required	Description
`purchaseYear`	number	Yes	Year vehicle was purchased (1900 to current year)
`purchasePrice`	number	Yes	Purchase price in USD (positive, max 10,000,000)
`vehicleType`	string	Yes	Type: sedan, suv, truck, luxury, economy, sports, ev, motorcycle, rv
`currentMileage`	number	No	Current mileage (non-negative, defaults to 0)

Response Example

{
  "success": true,
  "data": {
    "currentValue": 15712,
    "totalDepreciation": 9288,
    "totalDepreciationPercent": 37.2,
    "monthlyDepreciation": 155,
    "yearlyBreakdown": [
      {
        "year": 2020,
        "age": 0,
        "value": 25000,
        "depreciation": 0,
        "depreciationPercent": 0
      },
      {
        "year": 2021,
        "age": 1,
        "value": 21250,
        "depreciation": 3750,
        "depreciationPercent": 15
      }
      // ... more years
    ]
  },
  "meta": {
    "vehicleType": "sedan",
    "vehicleAge": 5,
    "calculatedAt": "2025-11-08T22:21:54.914Z"
  }
}

Code Examples

cURL

curl -X POST https://assetdropper.com/api/depreciate \
  -H "Content-Type: application/json" \
  -d '{
    "purchaseYear": 2020,
    "purchasePrice": 25000,
    "vehicleType": "sedan",
    "currentMileage": 50000
  }'

JavaScript (fetch)

const response = await fetch('https://assetdropper.com/api/depreciate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    purchaseYear: 2020,
    purchasePrice: 25000,
    vehicleType: 'sedan',
    currentMileage: 50000,
  }),
});

const data = await response.json();
console.log('Current Value:', data.data.currentValue);

Python (requests)

import requests

response = requests.post(
    'https://assetdropper.com/api/depreciate',
    json={
        'purchaseYear': 2020,
        'purchasePrice': 25000,
        'vehicleType': 'sedan',
        'currentMileage': 50000,
    }
)

data = response.json()
print(f"Current Value: ${data['data']['currentValue']}")

Error Responses

400 Bad Request

Invalid input parameters

{
  "statusCode": 400,
  "message": "Invalid input parameters"
}

429 Too Many Requests

Rate limit exceeded (100 requests per 24 hours)

{
  "statusCode": 429,
  "message": "Rate limit exceeded. Maximum 100 requests per 24 hours."
}

Building an automotive application? Check out AutoTrader for buy and sell new and used cars.