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

# Search Vehicles

`GET /api/v1/vehicles`

Deep search over the in-memory index (sub-10ms).

## Query parameters

- `make` string — Vehicle make (e.g., Audi, BMW)
- `model` string — Vehicle model (e.g., Q3). 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)
- `region` string — Market region (EU, US, Asia, Global)
- `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)
- `trim_exact` boolean — Match trim exactly (case-insensitive) instead of substring
- `q` string — Free keyword across make + model + trim (fuzzy)
- `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
  - `prev_page` string, nullable
  - `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

## Changes

- **2026-08-28** `6e7262d4aac0` — 2 info
  - added the new optional `query` request parameter `q`
  - added the new optional `query` request parameter `trim_exact`
- **2026-08-24** `9e80c113b037` — 1 info
  - added the new optional `query` request parameter `region`

[Change history](https://skmtc.dev/revcardata/apis/revcardata-rest-api/changes/api/v1/vehicles/get.md)

---

[API](https://skmtc.dev/revcardata/apis/revcardata-rest-api.md) · [All operations](https://skmtc.dev/revcardata/apis/revcardata-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/revcardata/revcardata-rest-api/revisions/9bbeceb1cea9/schema)