Vehicle Fluids & Capacities API Documentation
Welcome to Vehicle Databases API's Documentation
Vehicle Fluids & Capacities
GETJSON Response
Overview
This endpoint returns comprehensive fluid specifications, capacities, and maintenance requirements for a specific vehicle. It provides details on engine oil, brake fluid, coolant, transmission fluid, and fuel capacity to support service and automotive data integration.
COVERAGE
US region from 1999 to 2026
SUPPORT
Works for 17 characters VINs
HTTP Request
Endpoint
GET https://api.vehicledatabases.com/fluid-specs/{vin}Example — Python / Requests
Target:
Client:
import requests
response = requests.get(
"https://api.vehicledatabases.com/fluid-specs/{vin}",
headers={"x-authkey": "YOUR_API_KEY"}
)
print(response.json())GET Parameters
| Parameter | Required | Description |
|---|---|---|
| vin | ✓ | 17 characters VIN number |
JSON Response
The response is a JSON of all the information associated with a VIN number or YMMT.
Response Fields
| Parameter | Description |
|---|---|
| status | "success" or "error" |
| data | An object containing all data available. |
Example Response
{
"status": "success",
"vin": "5J8YD4H39LL044094",
"year": 2020,
"make": "Acura",
"model": "MDX",
"trim": "Base 4dr SH-AWD Automatic",
"data": [
{
"title": "Engine Oil",
"items": [
{
"key": "Grade",
"value": "API*"
},
{
"key": "Capacity",
"value": "5.7 quarts (with filter). After refill check oil level., 5.4 quarts. w/of. After refill check oil level."
},
{
"key": "Viscosity",
"value": "0W-20 (All TEMPS)"
},
{
"key": "Torque",
"value": "30 ft/lbs"
}
]
},
{
"title": "Brake Oil",
"items": [
{
"key": "Type",
"value": "(1) Acura Heavy Duty Brake Fluid DOT 3, P/N 08798-9008A"
}
]
},
{
"title": "Engine Coolant",
"items": [
{
"key": "Capacity",
"value": "7.8 quarts."
}
]
},
{
"title": "Transmission Fluid",
"items": [
{
"key": "Capacity",
"value": "9 speed AWD Q5DH Total Fill 7.7 quarts., 3.5 quarts Initial Fill."
}
]
},
{
"title": "Fuel Tank",
"items": [
{
"key": "Capacity",
"value": "19.5 gal"
}
]
}
]
}Error Responses
error
statusWhen an error occurs, the API returns an error status with a code and message.
| Code | Description | Resolution |
|---|---|---|
| 400 | Record(s) were not found for this vehicle. | Verify the VIN or YMMT is correct. |
| 401 | Invalid API Key | Check your API key for correctness and ensure it is properly formatted. |
| 403 | Rate limit exceeded | You have exceeded the number of allowed requests in a given time period. Please wait and try again. |
| 422 | Validation error | One or more parameters are invalid. Check the request parameters for correctness. |
| 500 | Internal server error | An unexpected error occurred on the server. Please try again later or contact support. |