Skip to main content
GET
/
api
/
vehicles
/
year-range
Get Vehicles by Year Range
curl --request GET \
  --url https://api.example.com/api/vehicles/year-range
{
  "vehicles": [
    {}
  ]
}

Request

startYear
integer
required
The starting year of the range (inclusive)
endYear
integer
required
The ending year of the range (inclusive)

Response

Returns an array of vehicles with manufacturing years between startYear and endYear (inclusive).
vehicles
Vehicle[]
Array of vehicle objects

Example

curl -X GET "http://localhost:8080/api/vehicles/year-range?startYear=2022&endYear=2024"

Response Example

[
  {
    "id": 1,
    "reference": "BMW2024A1B2",
    "brand": "BMW",
    "model": "X5",
    "year": 2024,
    "price": 150.00,
    "vehicleType": "SUV"
  },
  {
    "id": 2,
    "reference": "AUD2023C3D4",
    "brand": "Audi",
    "model": "Q7",
    "year": 2023,
    "price": 145.00,
    "vehicleType": "SUV"
  },
  {
    "id": 3,
    "reference": "MER2022E5F6",
    "brand": "Mercedes-Benz",
    "model": "GLE",
    "year": 2022,
    "price": 155.00,
    "vehicleType": "SUV"
  }
]
Both startYear and endYear are inclusive in the search. The query uses SQL BETWEEN clause internally.
Use this endpoint to filter vehicles by model year ranges, such as “2020-2024” for recent models or “2015-2019” for older inventory.

Build docs developers (and LLMs) love