---
title: "Catalog entries for free text, best first. Text that names nothing gives an empty list."
method: GET
path: "/v1/vehicles/search"
tags: ["Vehicles"]
---

# Catalog entries for free text, best first. Text that names nothing gives an empty list.

`GET /v1/vehicles/search`

## Request

- Base URL: `https://open.wenmarpro.com`
- URL: `https://open.wenmarpro.com/v1/vehicles/search`
- Auth: none declared

## Query parameters

- `q` string, required
- `scope` string
- `limit` integer

## Response `200`

Entries, best first.

- Entry[]
  - `body` string, nullable
  - `drive` string, nullable
  - `engine` string, nullable
  - `id` string, required: The stable id. It stays the same from one data release to the next for as long as the names do.
  - `make` string, required
  - `model` string, required
  - `submodel` string, nullable
  - `summary` string, required: One line naming everything above that is known.
  - `transmission` string, nullable
  - `vehicle_types` string[], required: NHTSA's vehicle types for this model year, such as `Truck`.
  - `year` integer, required

## Other responses

- `400`: `validation_failed`: `q` is missing.

---

[API](https://skmtc.dev/wenmarpro/apis/wenmar-open.md) · [All operations](https://skmtc.dev/wenmarpro/apis/wenmar-open/llms.txt) · [OpenAPI document](https://skmtc.dev/wenmarpro/apis/wenmar-open/revisions/1027b548b6f0?raw)