Documentation
Welcome to Vehicle Databases API's Documentation
Vehicle Maintenance
GETJSON Response
Overview
This API provides information about the OEM vehicle maintenance schedules at mileage intervals
COVERAGE
US Region Vehicles.
SUPPORT
Works for 17 characters VINs
HTTP Request
Endpoint
GET https://api.vehicledatabases.com/vehicle-maintenance/v4/{vin}Example — Python / Requests
Target:
Client:
import requests
response = requests.get(
"https://api.vehicledatabases.com/vehicle-maintenance/v4/{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. Each vin number has the following elements:
Response Fields
| Parameter | Description |
|---|---|
| status | "success" or "error" |
| data | An object containing all data available. |
Example Response
{
"status": "success",
"data": {
"vin": "2HGFE2F20NH507968",
"year": 2022,
"make": "Honda",
"model": "Civic",
"trim": "LX 4dr Sedan CVT",
"maintenance": [
{
"mileage": {
"miles": 15000,
"km": 24100
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 25000,
"km": 40200
},
"service_items": [
"Replace Automatic Transaxle (cvt) Fluid"
]
},
{
"mileage": {
"miles": 30000,
"km": 48200
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 45000,
"km": 72400
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 50000,
"km": 80400
},
"service_items": [
"Replace Automatic Transaxle (cvt) Fluid"
]
},
{
"mileage": {
"miles": 60000,
"km": 96500
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 75000,
"km": 120700
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Automatic Transaxle (cvt) Fluid",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 90000,
"km": 144800
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 100000,
"km": 160900
},
"service_items": [
"Replace Automatic Transaxle (cvt) Fluid"
]
},
{
"mileage": {
"miles": 105000,
"km": 168900
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 120000,
"km": 193100
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 125000,
"km": 201100
},
"service_items": [
"Replace Automatic Transaxle (cvt) Fluid"
]
},
{
"mileage": {
"miles": 135000,
"km": 217200
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 150000,
"km": 241400
},
"service_items": [
"Replace Air Cleaner Element",
"Replace Automatic Transaxle (cvt) Fluid",
"Replace Cabin Air Filter"
]
},
{
"mileage": {
"miles": 160000,
"km": 257400
},
"service_items": [
"Inspect Idle Speed"
]
}
]
}
}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. |