---
title: "Search listings"
method: GET
path: "/v1/listings"
---

# Search listings

`GET /v1/listings`

## Request

- Base URL: `https://api.omniaauto.ca`
- URL: `https://api.omniaauto.ca/v1/listings`
- Auth: HTTP bearer

**One row per LISTING — cross-listings included.** A vehicle listed by several locations of one dealer group returns once per location, and `total` counts listings, not vehicles (856,200 listings describe 618,078 vehicles). This is deliberate and unchanged: deduplicate on `vin` if you want one row per vehicle, or use the MCP server's `search_listings` tool, which is deduplicated for you.

**Paging:** follow `next_cursor` until it is null. Offset paging is supported for shallow pages only.

**Rate limits:** every authenticated response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (seconds until the bucket refills), so you can self-throttle instead of discovering the ceiling as a 429.

## Query parameters

- `make` string
- `model` string
- `trim` string
- `trim_standard` string
- `year` integer
- `year_min` integer
- `year_max` integer
- `condition` 'New' | 'Used' | 'Certified' | 'Demo'
- `body_type` string
- `drivetrain` string
- `fuel_type` string
- `province` string
- `city` string
- `near` string
- `radius_km` number
- `oem` string
- `price_min` number
- `price_max` number
- `mileage_min` number
- `mileage_max` number
- `sort` 'price' | 'mileage' | 'year' | 'last_seen' | 'first_seen' | 'distance'
- `order` 'asc' | 'desc'
- `limit` integer
- `offset` integer
- `expand` string
- `cursor` string
- `listed_since` string, date
- `listed_before` string, date
- `fields` string

## Response `200`

Matching listings + total count

## Other responses

- `400`: offset_too_large — offset exceeded the 1000-row deep-pagination cap
- `401`: Missing/invalid key
- `429`: Rate limited

---

[API](https://skmtc.dev/omniaauto/apis/omniaauto-canadian-vehicle-listings-api.md) · [All operations](https://skmtc.dev/omniaauto/apis/omniaauto-canadian-vehicle-listings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/omniaauto/apis/omniaauto-canadian-vehicle-listings-api/revisions/f46ac0dabe3d?raw)