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

Get started for freeTalk to us