Skip to main content

API Documentation

Integrate vehicle depreciation calculations into your applications.

📖

Overview

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

🔌

RESTful API

Simple JSON-based API with predictable resource-oriented URLs

⏱️

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

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

Parameters

FieldTypeRequiredDescription
purchaseYearnumberYesYear vehicle was purchased (1900 to current year)
purchasePricenumberYesPurchase price in USD (positive, max 10,000,000)
vehicleTypestringYesType: sedan, suv, truck, luxury, economy, sports, ev, motorcycle, rv
currentMileagenumberNoCurrent 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

🚀

Quick Start

Copy any of these examples to get started in seconds

cURL

cURL

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

JavaScript (fetch)

javascript
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);
PY

Python (requests)

python
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

400 Bad Request

Invalid input parameters

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

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 vehicle listings and marketplace.

HomeBrowseCalcLibrarySaved