--- title: "POST /api/v1/tier1.vehicle-models.search" method: POST path: "/api/v1/tier1.vehicle-models.search" tags: ["tier1"] --- # POST /api/v1/tier1.vehicle-models.search `POST /api/v1/tier1.vehicle-models.search` ## Request - Base URL: `https://api.partly.com` (the document declares no server; this is the origin it was published from) - URL: `https://api.partly.com/api/v1/tier1.vehicle-models.search` - Auth: none declared. Required headers: `authorization` Search vehicle models (families and their members) by a free-text query: a model, or a make then a model. Returns the stable model and family ids used in `VehicleVariant.typed_properties`, for model filter pickers. ## Headers - `authorization` string, required: UTF-8 encoded string ## Request body - Tier1VehicleModelSearchRequest - `cursor` string: UTF-8 encoded string - `limit` integer: 32-bit unsigned integer - `query` string, required: UTF-8 encoded string ## Response `200` 200 OK - Tier1VehicleModelSearchResponse - `items` Tier1VehicleModelSearchItem[], required: Expandable array type - `family` Tier1Labelled, required: A recognised value: its stable id and display name. - `id` string, required: UTF-8 encoded string - `name` string, required: UTF-8 encoded string - `id` string, required: UTF-8 encoded string - `make` Tier1Labelled, required: A recognised value: its stable id and display name. - `id` string, required: UTF-8 encoded string - `name` string, required: UTF-8 encoded string - `name` string, required: UTF-8 encoded string - `next_cursor` string: UTF-8 encoded string ## Other responses - `default`: Error cases ## Changes - **2026-10-15** `d73948080dc7`: 1 info - endpoint added [Operation history](https://skmtc.dev/partly/apis/core-server/changes/api/v1/tier1.vehicle-models.search/post.md) --- [API](https://skmtc.dev/partly/apis/core-server.md) · [All operations](https://skmtc.dev/partly/apis/core-server/llms.txt) · [OpenAPI document](https://skmtc.dev/partly/apis/core-server/revisions/19dd5c84162b?raw)