---
title: "Search Vehicles"
method: GET
path: "/api/v1/vehicles"
tags: ["1. Search & Listing"]
---

# Search Vehicles

`GET /api/v1/vehicles`

Deep search functionality returning fundamental vehicle identification data.

## Query parameters

- `make` string — Vehicle make (e.g., Audi, BMW)
- `model` string — Vehicle model (e.g., Q3). Uses fuzzy match.
- `year` integer — Manufacturing year (e.g., 2024)
- `trim` string — Trim or keyword (e.g., Competition)
- `body_type` string — Body style (e.g., SUV, Sedan)
- `fuel_type` string — Fuel type (e.g., Electric, Gasoline)
- `min_hp` integer — Minimum horsepower (e.g., 300)
- `min_ev_range_km` integer — Minimum EV Range in KM
- `max_acceleration_0_100` number — Max 0-100 km/h time (e.g., 4.5)
- `limit` integer — Max results per page
- `skip` integer — Pagination offset

## Response `200`

Successful Response

- SearchResponse
  - `total_found` integer, required
  - `returned` integer, required
  - `limit` integer, required
  - `skip` integer, required
  - `next_page` string, nullable — URL for the next page of results
  - `prev_page` string, nullable — URL for the previous page of results
  - `data` VehicleBasic[], required
    - `id` integer, required
    - `make` string, nullable
    - `model` string, nullable
    - `year` integer, nullable
    - `trim` string, nullable
    - `body_type` string, nullable

## Other responses

- `401` — Unauthorized - Invalid API Key
- `422` — Validation Error
- `429` — Too Many Requests - Quota Exceeded

---

[API](https://skmtc.net/revcardata/apis/revcardata-rest-api.md) · [All operations](https://skmtc.net/revcardata/apis/revcardata-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revcardata/revcardata-rest-api/versions/8a9993554c3e/schema)