---
title: "Search vehicle listings"
method: GET
path: "/listing"
tags: ["Listings"]
---

# Search vehicle listings

`GET /listing`

Search current vehicle listings on the market. Filter by make, model, and year with pagination support.

## Query parameters

- `make` 'acura' | 'alfa-romeo' | 'audi' | 'bmw' | 'cadillac' | 'chevrolet' | 'citroen' | 'cupra' | 'dacia' | 'dodge' | 'ferrari' | 'fiat' | 'ford' | 'gmc' | 'honda' | 'hyundai' | 'jaguar' | 'jeep' | 'kia' | 'land-rover' | 'lexus' | 'mazda' | 'mercedes-benz' | 'mg' | 'mini' | 'mitsubishi' | 'nissan' | 'opel' | 'peugeot' | 'porsche' | 'ram' | 'renault' | 'seat' | 'skoda' | 'subaru' | 'suzuki' | 'tesla' | 'toyota' | 'volvo' | 'vw'
- `model` string
- `year` integer
- `limit` integer
- `offset` integer

## Response `200`

List of vehicle listings

- ListingResponse
  - `listings` object[], required
    - `vin` string
    - `specifications` object
      - `make` string, nullable
      - `model` string, nullable
      - `fuel` string, nullable
      - `transmission` string, nullable
      - `registrationDate` string, nullable
    - `availability` object
      - `imagesCount` integer
      - `plateNumbersCount` integer
      - `historyItemsCount` integer
  - `pagination` object, required
    - `limit` integer
    - `offset` integer

## Other responses

- `400` — Invalid parameters
- `401` — Invalid or missing API key

---

[API](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api.md) · [All operations](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/carapi/carapi-dev-automotive-data-api/revisions/0ad5b085852b/schema)
