Skip to main content
GET
/
api
/
vehicles
/
filter
curl -X GET "http://localhost:8080/api/vehicles/filter?brand=BMW"
[
  {
    "id": 1,
    "reference": "BMW2024A1B2",
    "brand": "BMW",
    "model": "X5",
    "hp": 335,
    "autonomy": 650,
    "averageconsumption": 8.5,
    "description": "Luxury SUV with advanced features",
    "price": 65000.00,
    "year": 2024,
    "fuelType": "diesel",
    "mileage": 15000,
    "extras": "Navigation, Leather seats, Sunroof",
    "createdAt": "2024-01-15T10:30:00",
    "updatedAt": "2024-02-20T14:45:00",
    "doors": 5,
    "vehicleType": "SUV",
    "offers": "Yes",
    "images": [
      {
        "id": 1,
        "imageUrl": "https://example.com/bmw-x5-front.jpg"
      }
    ]
  }
]
Filters vehicles using multiple optional criteria. All parameters are optional and can be combined. Empty strings are treated as null.

Query Parameters

brand
string
Filter by brand name
model
string
Filter by model name
year
integer
Filter by manufacturing year
vehicleType
string
Filter by vehicle type (e.g., sedan, suv, truck, motorcycle)

Response

Returns an array of Vehicle objects matching all specified criteria.
id
long
Unique identifier for the vehicle
reference
string
Auto-generated unique reference code
brand
string
Vehicle brand name
model
string
Vehicle model name
hp
integer
Horsepower
autonomy
integer
Autonomy/range in kilometers
averageconsumption
double
Average fuel consumption
description
string
Vehicle description
price
decimal
Vehicle price
year
integer
Manufacturing year
fuelType
string
Fuel type
mileage
long
Mileage in kilometers
extras
string
Additional features and extras
createdAt
datetime
Timestamp when created
updatedAt
datetime
Timestamp when last updated
doors
integer
Number of doors
vehicleType
string
Type of vehicle
offers
string
Special offers status
images
array
Array of vehicle images
curl -X GET "http://localhost:8080/api/vehicles/filter?brand=BMW"
[
  {
    "id": 1,
    "reference": "BMW2024A1B2",
    "brand": "BMW",
    "model": "X5",
    "hp": 335,
    "autonomy": 650,
    "averageconsumption": 8.5,
    "description": "Luxury SUV with advanced features",
    "price": 65000.00,
    "year": 2024,
    "fuelType": "diesel",
    "mileage": 15000,
    "extras": "Navigation, Leather seats, Sunroof",
    "createdAt": "2024-01-15T10:30:00",
    "updatedAt": "2024-02-20T14:45:00",
    "doors": 5,
    "vehicleType": "SUV",
    "offers": "Yes",
    "images": [
      {
        "id": 1,
        "imageUrl": "https://example.com/bmw-x5-front.jpg"
      }
    ]
  }
]

Build docs developers (and LLMs) love