CAR DB API Documentation

CAR DB API synchronizes data with an external database (Car2DB) every night at 3 AM UTC, providing detailed information about car models, variants, and specifications.

Base URL

• URL: https://cardb.cfdnext.com/

Endpoints

Variants

• URL: /variants/:brand?/:model?/:generation?/:serie?/:variant?
• Method: GET
• Description: Retrieves information about car variants. The endpoint provides a drill-down mechanism; specifying a brand returns all models for that brand, and so on. When a variant is specified, it returns all specifications.
• Parameters:
  • brand (optional): Brand of the car.
  • model (optional): Model of the car.
  • generation (optional): Generation of the car model.
  • serie (optional): Series of the car model.
  • variant (optional): Specific variant of the car model.
• Response Details:
  • If no parameters are specified, the endpoint returns all available car brands.
  • Specifying a brand returns all models for that brand. Further specifying model, generation, serie, or variant narrows down the response to more specific details (if data in the DB, if not it returns an error).
  • When variant is specified, the endpoint returns all the following specifications: transmission, doors, emissionClassification, seats, fuel, displacement, powerInPS, width, length, height (if data in the DB).

Specifications (Specs)

• URL: /specs/:key
• Method: GET
• Description: Provides possible values for a car specifications based on the provided key.
• Path Parameter:
  • key: A key representing a specific aspect of car specifications.
• Possible Keys:
  • brand
  • model
  • generation
  • serie
  • variant
  • transmission
  • emissionClassification
  • doors
  • seats
  • fuel
  • displacement
  • powerInPS
  • width
  • length
  • height

Direct DB values

• URL: /db/:key
• Method: GET
• Description: Provides all values from the database based on the provided key.
• Path Parameter:
  • key: A key representing a step of the drill-down mechanism for car variant specification.
• Possible Keys:
  • brands
  • models
  • generations
  • series
  • variants

Notes

• Correct parameter spelling and format are essential for accurate responses.
• The API synchronizes with the Car2DB database daily at 3 AM UTC. Ensure up-to-date queries by considering the synchronization schedule.