---
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
- `403` — Invalid or missing API key, suspended account, or inactive subscription
- `429` — Monthly quota exhausted or per-minute rate limit exceeded. Quota responses carry resetDate; rate-limit responses carry a Retry-After header.

## Changes

- **2026-08-10** `cf1d4e12baca` — 6 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
  - removed the non-success response with the status `401`
  - added the optional property `code` to the response with the `400` status
  - …2 more

[Change history](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api/changes/listing/get.md)

---

[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/cf1d4e12baca/schema)