Car Database API

Complete Car Database REST API - Documentation & Samples. Please see the sections below for detailed information on the possible uses of the Car API.

Example output Formats

All Format Types

Additional Parameters

Language English, Russian(ru,en-default)

https://databases.one/api/?format=json&select=make&lang=en&api_key=Your_Database_Api_Key

Is Active(0,1-default)

https://databases.one/api/?format=json&select=make&lang=ru&is_active=1&api_key=Your_Database_Api_Key

Check Parameters

Get date update(YYYY-MM-DD)

https://databases.one/api/?format=json&select=date_update&api_key=Your_Database_Api_Key

Count all makes

https://databases.one/api/?format=json&select=count_makes&api_key=Your_Database_Api_Key

Count all models

https://databases.one/api/?format=json&select=count_models&api_key=Your_Database_Api_Key

Count all generations

https://databases.one/api/?format=json&select=count_generations&api_key=Your_Database_Api_Key

Count all trims

https://databases.one/api/?format=json&select=count_trims&api_key=Your_Database_Api_Key

Get all cardatabase data by dates

Get all data from last update

https://databases.one/api/?format=json&select=all&api_key=Your_Database_Api_Key

Get all data from date + 1 month(start_date=YYYY-MM-DD)

https://databases.one/api/?format=json&select=all&start_date=2017-09-08&api_key=Your_Database_Api_Key

Example Get Car Makes

Car Makes

Get All Car Makes

https://databases.one/api/?format=json&select=make&api_key=Your_Database_Api_Key

Get Multiple Car Makes(example Toyota, BMW, Audi - make_id=140,16,9)

https://databases.one/api/?format=json&select=make&make_id=140,16,9&api_key=Your_Database_Api_Key

Check Single Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=make&make_id=140&api_key=Your_Database_Api_Key

Example Get Car Models

Car Models

Get All Car Models

https://databases.one/api/?format=json&select=model&api_key=Your_Database_Api_Key

Get All Models for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=model&make_id=140&api_key=Your_Database_Api_Key

Check Single Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=model&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Or short Api query - Get Single Car Model:

https://databases.one/api/?format=json&select=model&model_id=876&api_key=Your_Database_Api_Key

Example Get Car Generations

Car Generations

Get All Car Generations

https://databases.one/api/?format=json&select=generation&api_key=Your_Database_Api_Key

Get All Generations for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=generation&make_id=140&api_key=Your_Database_Api_Key

Get All Generations for Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=generation&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Check Single Car Generation(example Toyota Corolla VI (E90) - make_id=140&model_id=876&generation_id=4410)

https://databases.one/api/?format=json&select=generation&make_id=140&model_id=876&generation_id=4410&api_key=Your_Database_Api_Key

Or short Api query - Get Single Car Generation

https://databases.one/api/?format=json&select=generation&generation_id=4410&api_key=Your_Database_Api_Key

Example Get Car Trims

Car Trims

Get All Car Trims

https://databases.one/api/?format=json&select=trim&api_key=Your_Database_Api_Key

Get All Trims for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=trim&make_id=140&api_key=Your_Database_Api_Key

Get All Trims for Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=trim&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Get All Trims for Car Generation(example Toyota Corolla - VI (E90) - make_id=140&model_id=876&generation_id=4410))

https://databases.one/api/?format=json&select=trim&make_id=140&model_id=876&generation_id=4410&api_key=Your_Database_Api_Key

Check Single Trim(example Toyota Corolla - VI (E90) Levin 1.6 MT (145 Hp) - make_id=140&model_id=876&generation_id=4410&trim_id=40912)

https://databases.one/api/?format=json&select=trim&make_id=140&model_id=876&generation_id=4410&trim_id=40912&api_key=Your_Database_Api_Key

Or short Api query - Get Single Car Trim

https://databases.one/api/?format=json&select=trim&trim_id=40912&api_key=Your_Database_Api_Key

Example Get Car Years

Car Years

Get All Car Years

https://databases.one/api/?format=json&select=year&api_key=Your_Database_Api_Key

Get All Years for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=year&make_id=140&api_key=Your_Database_Api_Key

Get All Years for Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=year&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Get All Years for Car Generation(example Toyota Corolla VI (E90) - make_id=140&model_id=876&generation_id=4410)

https://databases.one/api/?format=json&select=year&make_id=140&model_id=876&generation_id=4410&api_key=Your_Database_Api_Key

Get All Years for Car Trim(example Toyota Corolla VI (E90) Levin 1.6 MT (145 Hp) - make_id=140&model_id=876&generation_id=4410&trim_id=40912)

https://databases.one/api/?format=json&select=year&make_id=140&model_id=876&generation_id=4410&trim_id=40912&api_key=Your_Database_Api_Key

Check Single Car Year(example Toyota Corolla VI (E90) Levin 1.6 MT (145 Hp) 1987 - make_id=140&model_id=876&generation_id=4410&trim_id=40912&year=1987)

https://databases.one/api/?format=json&select=year&make_id=140&model_id=876&generation_id=4410&year=1987&api_key=Your_Database_Api_Key

Or short Api query - Get Single Car Year

https://databases.one/api/?format=json&select=year&year=1987&api_key=Your_Database_Api_Key

Example Get Car Details

Car Details

Get Single Trim Details(example Toyota Corolla - VI (E90) Levin 1.6 MT (145 Hp) - make_id=140&model_id=876&generation_id=4410&trim_id=40912)

https://databases.one/api/?format=json&select=trim&make_id=140&model_id=876&generation_id=4410&trim_id=40912&api_key=Your_Database_Api_Key

Or short Api query - Get Car Details

https://databases.one/api/?format=json&select=detail&trim_id=40912&api_key=Your_Database_Api_Key

Other Car Specifications

Car Body Types

Get All Car Body Types

https://databases.one/api/?format=json&select=body&api_key=Your_Database_Api_Key

Get All Body Types for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=body&make_id=140&api_key=Your_Database_Api_Key

Get All Body Types for Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=body&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Car Drive Types

Get All Car Drive Types

https://databases.one/api/?format=json&select=drive&api_key=Your_Database_Api_Key

Get All Drive Types for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=drive&make_id=140&api_key=Your_Database_Api_Key

Get All Drive Types for Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=drive&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Car Gearbox Types

Get All Car Gearbox Types

https://databases.one/api/?format=json&select=gearbox&api_key=Your_Database_Api_Key

Get All Gearbox Types for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=gearbox&make_id=140&api_key=Your_Database_Api_Key

Get All Gearbox Types for Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=gearbox&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Car Engine Types

Get All Car Engine Types

https://databases.one/api/?format=json&select=engine_type&api_key=Your_Database_Api_Key

Get All Engine Types for Car Make(example Toyota - make_id=140)

https://databases.one/api/?format=json&select=engine_type&make_id=140&api_key=Your_Database_Api_Key

Get All Engine Types for Car Model(example Toyota Corolla - make_id=140&model_id=876)

https://databases.one/api/?format=json&select=engine_type&make_id=140&model_id=876&api_key=Your_Database_Api_Key

Example Errors

Api Errors

Databases.one provides conventional HTTP/s response codes to indicate errors. Not all errors map cleanly into HTTP/s response codes, so when a request is valid but is not successful, the API will return a system error code(multiple format).

System Api error:

111

111 "Invalid Api Key"

222

222 "Expired Api Key"

333

333 "Invalid Language Variable"

444

444 "Invalid Select Variable"

555

555 "No Access"

666

666 "Missing Variables"

HTTP/s Status Code Summary:

200

200 OK - Everything worked as expected.

400

400 Bad Request - Likely a missing required parameter.

401

401 Unauthorized - No access.

402

402 Request Failed - Parameters were valid but the request failed.

403

403 Forbidden

404

404 Not Found - The request doesn't exist.

500, 502, 503, 504

500, 502, 503, 504 Server errors - something went wrong on databases.one end.

Let's Get In Touch!

Ready to start your next project with us? That's great! Send us an email and we will get back to you as soon as possible!

support@databases.one

Terms - Privacy

Please read our terms of service before you start to use our site, as these will apply to your use of our site. By using our site, you confirm that you accept these terms of use and that you agree to comply with them. If you do not agree to these terms of use, you must not use our site.