---
title: "GET /listings/{vin}"
method: GET
path: "/listings/{vin}"
tags: ["listings"]
---

# GET /listings/{vin}

`GET /listings/{vin}`

## Path parameters

- `vin` string, required — Vehicle Identification Number

## Query parameters

- `createdAt` string
- `distance` number
- `includeUnpriced` string
- `includes` string
- `limit` number
- `page` number
- `retailListing.miles` string
- `retailListing.price` string
- `sort` string
- `updatedAt` string
- `vehicle.bodyStyle` string
- `vehicle.drivetrain` string
- `vehicle.exteriorColor` string
- `vehicle.fuel` string
- `vehicle.interiorColor` string
- `vehicle.make` string
- `vehicle.model` string
- `vehicle.transmission` string
- `vehicle.trim` string
- `vehicle.year` string
- `zip` string

## Response `200`

Success

- object
  - `api` API
    - `description` string, required
    - `from` string, required
    - `login` string, required
    - `name` string, required
    - `repo` string, required
    - `signup` string, required
    - `type` string, required
    - `url` string, required
  - `data` Row[], required
  - `facets` object
  - `links` object, required
    - `first` string
    - `home` string
    - `last` string
    - `next` string
    - `prev` string
    - `self` string
    - `toggleFacets` string
    - `toggleTotal` string
  - `total` number
  - `totalFormatted` string
  - `user` ApiUser
    - `accessState` 'active' | 'suspended'
    - `admin` boolean
    - `authenticated` boolean, required
    - `browser` string
    - `city` string, required
    - `continent` string, required
    - `country` string, required
    - `edgeDistanceKilometers` number
    - `edgeDistanceMiles` number
    - `edgeLocation` string, required
    - `email` string
    - `flag` string, required
    - `image` string
    - `ip` string, required
    - `isp` string, required
    - `latencyMilliseconds` number, required
    - `localTime` string, required
    - `metro` string, required
    - `name` string
    - `org` string
    - `os` string, required
    - `plan` 'Free' | 'Starter' | 'Growth' | 'Scale', required
    - `recentInteractions` number, required
    - `region` string, required
    - `requestId` string, required
    - `serviceLatency` number
    - `support` string
    - `timezone` string, required
    - `trustScore` number, required
    - `upgrade` string
    - `userAgent` string
    - `zipcode` string

---

[API](https://skmtc.net/auto/apis/drivly-api.md) · [All operations](https://skmtc.net/auto/apis/drivly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/auto/drivly-api/revisions/8fb62eeae60e/schema)