---
title: "Get vehicles with lead context"
method: GET
path: "/api/vehicles-with-context"
tags: ["Vehicles Lead Context - Protected"]
---

# Get vehicles with lead context

`GET /api/vehicles-with-context`

Get vehicles with comprehensive lead context.

This endpoint provides full vehicle information with lead context for AI agent queries.
Supports flexible filtering on multiple parameters.

Returns comprehensive vehicle data including:
- Basic details (brand, model, version, year, kms, price)
- Point of sale information
- Technical specifications
- Registration details
- Stock management info
- Status flags
- Media (pictures)

**Authentication required**: Company ID extracted from authenticated user.

## Query parameters

- `pv_id` integer, nullable — Filter by point of sale ID
- `brand` string, nullable — Filter by brand (partial match)
- `model` string, nullable — Filter by model (partial match)
- `fuel_type` string, nullable — Filter by fuel type (e.g., Gasolina, Diesel, Elétrico)
- `gearbox` string, nullable — Filter by gearbox (e.g., Manual, Automática)
- `year_min` integer, nullable — Minimum year
- `year_max` integer, nullable — Maximum year
- `price_min` number, nullable — Minimum price
- `price_max` number, nullable — Maximum price
- `kms_max` integer, nullable — Maximum kilometers
- `is_imported` boolean, nullable — Filter imported vehicles
- `condition` string, nullable — Filter by condition (e.g., Usado, Novo)
- `body_type` string, nullable — Filter by body type
- `segment_name` string, nullable — Filter by segment name
- `color` string, nullable — Filter by vehicle color

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)