Tuningfiles

TuningFiles API Docs

Vehicle Database REST API

Build your own vehicle catalogue

The TuningFiles API gives subscribed partners access to vehicle types, manufacturers, models, generations, engines, performance data, dyno chart values and available remap information.

Use it when you want to build a custom catalogue interface in your own website or application instead of using the ready-made iframe.

Authentication

All API requests require an API key. Send the key in the custom request header below. Do not send it as a URL query parameter.

curl -X GET "https://api.tuningfiles.com/vdb/types" \
  -H "x-api-key: YOUR_API_KEY"

Language

API methods accept the `X-LANG` header. Use `en` for English. Other supported languages include Norwegian Bokmal, Spanish, Russian, Croatian, Latvian, Lithuanian and Chinese variants.

curl -X GET "https://api.tuningfiles.com/vdb/types" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-lang: en"

Rate limits

  • Vehicle Database REST API: 3600 calls per hour.
  • Support REST API: 3600 calls per hour.
  • File Tuning REST API: no current limits.

Limits are per API key and reset every hour.

Error format

Errors are returned with matching HTTP status codes and a JSON body containing `code` and `message`.

{
  "error": {
    "code": 403,
    "message": "Invalid API key"
  }
}

Methods

Vehicle Database endpoint details

Open a method to view parameters, response codes, a curl request and a compact JSON response example.

GET /vdb/subscription Check for active subscription

Checks whether the authenticated API key has access to the Vehicle Database API.

Parameters

No path or query parameters.

Responses

200 Success 403 Invalid API key

Request example

curl -X GET "https://api.tuningfiles.com/vdb/subscription" \
  -H "x-api-key: YOUR_API_KEY"

Response example

{
  "name": "Vehicle Database API",
  "active": true,
  "end_date": "2020-06-07T10:49:03+00:00"
}
GET /vdb/types List vehicle types

Returns a list of all available vehicle types.

Parameters

No path or query parameters.

Responses

200 Success 401 Not enough permissions / Unauthorized 403 Invalid API key

Request example

curl -X GET "https://api.tuningfiles.com/vdb/types" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-lang: en"

Response example

[
  {
    "id": 1,
    "name": "Cars & LCV",
    "slug": "cars",
    "icon_url": "https://d1etxasddeekf8.cloudfront.net/app-assets/vdb/logos/icl_cars.png"
  }
]
GET /vdb/types/{type_id} View vehicle type

Returns information about a specific vehicle type.

Parameters

type_id path yes

Vehicle type ID

Responses

200 Success 401 Not enough permissions / Unauthorized 403 Invalid API key 404 Type does not exist

Request example

curl -X GET "https://api.tuningfiles.com/vdb/types/1" \
  -H "x-api-key: YOUR_API_KEY"

Response example

{
  "id": 1,
  "name": "Cars & LCV",
  "slug": "cars",
  "icon_url": "https://d1etxasddeekf8.cloudfront.net/app-assets/vdb/logos/icl_cars.png"
}
GET /vdb/manufacturers/{vehicle_type_id} List manufacturers

Lists manufacturers based on vehicle type.

Parameters

vehicle_type_id path yes

Vehicle type ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 No manufacturers found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/manufacturers/1" \
  -H "x-api-key: YOUR_API_KEY"

Response example

[
  {
    "id": 7667,
    "name": "Acura",
    "slug": "acura",
    "brand_logo": "https://d1etxasddeekf8.cloudfront.net/app-assets/vdb/logos/acura.png",
    "vehicle_type": "Cars & LCV",
    "vehicle_type_id": 1
  }
]
GET /vdb/manufacturers/view/{manufacturer_id} View manufacturer

Returns information about a specific manufacturer.

Parameters

manufacturer_id path yes

Manufacturer ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 Manufacturer not found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/manufacturers/view/7667" \
  -H "x-api-key: YOUR_API_KEY"

Response example

{
  "id": 7667,
  "name": "Acura",
  "slug": "acura",
  "brand_logo": "https://d1etxasddeekf8.cloudfront.net/app-assets/vdb/logos/acura.png",
  "vehicle_type": "Cars & LCV",
  "vehicle_type_id": 1
}
GET /vdb/models/{manufacturer_id} List models

Lists models based on manufacturer.

Parameters

manufacturer_id path yes

Manufacturer ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 No models found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/models/1026" \
  -H "x-api-key: YOUR_API_KEY"

Response example

[
  {
    "id": 1027,
    "name": "145",
    "manufacturer": "Alfa Romeo",
    "manufacturer_id": 1026,
    "model_photo": "https://d1etxasddeekf8.cloudfront.net/app-assets/vdb/vehicleimages/alfa_145.jpg",
    "slug": "145"
  }
]
GET /vdb/models/view/{model_id} View model

Returns information about a specific model.

Parameters

model_id path yes

Model ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 Model not found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/models/view/1027" \
  -H "x-api-key: YOUR_API_KEY"

Response example

{
  "id": 1027,
  "name": "145",
  "manufacturer": "Alfa Romeo",
  "manufacturer_id": 1026,
  "model_photo": "https://d1etxasddeekf8.cloudfront.net/app-assets/vdb/vehicleimages/alfa_145.jpg",
  "model_photo_unbranded": "https://d1etxasddeekf8.cloudfront.net/app-assets/vdb/vehicleimages/alfa_145.jpg",
  "slug": "145"
}
GET /vdb/generations/{model_id} List model generations

Lists available generations for a specific model.

Parameters

model_id path yes

Model ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 No generations found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/generations/138" \
  -H "x-api-key: YOUR_API_KEY"

Response example

[
  {
    "id": 164,
    "name": "8L",
    "slug": "8l",
    "model_id": 138,
    "year": 1996,
    "yearend": 2003,
    "model": "A3",
    "manufacturer": "Audi",
    "manufacturer_id": 1088
  }
]
GET /vdb/generations/view/{generation_id} View generation

Returns information about a specific model generation.

Parameters

generation_id path yes

Generation ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 Generation not found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/generations/view/167" \
  -H "x-api-key: YOUR_API_KEY"

Response example

{
  "id": 167,
  "name": "8V",
  "slug": "8v",
  "model_id": 138,
  "year": 2012,
  "yearend": 2016,
  "model": "A3",
  "manufacturer": "Audi",
  "manufacturer_id": 1088
}
GET /vdb/engines/{generation_id} List engines

Lists engines for a specific model generation.

Parameters

generation_id path yes

Generation ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 No engines found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/engines/167" \
  -H "x-api-key: YOUR_API_KEY"

Response example

[
  {
    "id": 2790,
    "name": "1.8 20V 125hp 170Nm",
    "slug": "1-8-20v-125hp-170nm",
    "type": "Petrol",
    "power": 125,
    "torque": 170,
    "cylinders": 4,
    "fuel_name": "Petrol"
  }
]
GET /vdb/engines/view/{engine_id} View engine

Returns detailed engine information, including ECU/TCU data, dyno values, remap stages, available options, read tools and read methods.

Parameters

engine_id path yes

Engine ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 Engine not found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/engines/view/2790" \
  -H "x-api-key: YOUR_API_KEY"

Response example

{
  "id": 2790,
  "name": "1.8 20V 125hp 170Nm",
  "type": "Petrol",
  "power": 125,
  "torque": 170,
  "hp_values": "0,9,32,54,72,92,113,125,0,0",
  "nm_values": "0,79,135,155,155,162,170,153,0,0",
  "rpm_values": "0,1000,2000,3000,4000,5000,6000,7000,8000,9000",
  "options": [
    {
      "name": "DPF",
      "code": "DPF OFF",
      "description": "Removal of DPF"
    }
  ],
  "remap_stages": [
    {
      "stage_no": 1,
      "power": 136,
      "torque": 201,
      "modifications": ""
    }
  ],
  "read_tools": [
    {
      "id": 4,
      "name": "Alientech K-Tag"
    }
  ],
  "read_methods": [
    {
      "id": 1,
      "value": "ODB"
    }
  ]
}
GET /vdb/engines/search Search engine

Searches for engines. Query must be at least three characters.

Parameters

query query yes

Search query, minimum 3 characters

fuel query no

Fuel type filter

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 Nothing found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/engines/search?query=1.9%20TDI&fuel=Diesel" \
  -H "x-api-key: YOUR_API_KEY"

Response example

[
  {
    "id": 1028,
    "name": "1.9 JTD (1997) 105hp 255Nm",
    "type": "Turbo Diesel",
    "power": 105,
    "torque": 255,
    "fuel_name": "Diesel"
  }
]
GET /vdb/performance/{generation_id}/{engine_id} View vehicle performance

Returns vehicle performance data for a model generation and engine combination.

Parameters

generation_id path yes

Generation ID

engine_id path yes

Engine ID

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 No data

Request example

curl -X GET "https://api.tuningfiles.com/vdb/performance/167/2790" \
  -H "x-api-key: YOUR_API_KEY"

Response example

{
  "id": 8300,
  "fuel_consumption_avg": 10.6,
  "top_speed": 250,
  "zero_to_hundred": 6.2,
  "top_speed_st1": 281,
  "zero_to_hundred_st1": 5
}
GET /vdb/search Search

Searches manufacturers, models and engine names and returns matching vehicle information. Query must be at least two characters.

Parameters

query query yes

Search query, minimum 2 characters

Responses

200 Success 400 Missing or wrong parameter supplied 401 Not enough permissions / Unauthorized 403 Invalid API key 404 Nothing found

Request example

curl -X GET "https://api.tuningfiles.com/vdb/search?query=Audi%20A4" \
  -H "x-api-key: YOUR_API_KEY"

Response example

[
  {
    "type_id": 1,
    "type_name": "Cars & LCV",
    "manufacturer_id": 1088,
    "manufacturer_name": "Audi",
    "model_id": 7737,
    "model_common_name": "A4 B5",
    "generation_id": 169,
    "generation_name": "B5",
    "engine_id": 2770,
    "engine_name": "1.9 TDI 90Hp 210Nm"
  }
]

Need API access?

You need an active subscription and API key to use the Vehicle Database REST API. Create an account or contact us if you want help choosing the right setup.

Login Contact us