---
title: "Listing by id"
method: GET
path: "/listing/car/auction/{id}"
tags: ["Car Search"]
---

# Listing by id

`GET /listing/car/auction/{id}`

Get a particular auction listing by its id

## Path parameters

- `id` string, string, required

## Query parameters

- `api_key` string
- `append_api_key` boolean
- `include_relevant_links` boolean

## Response `200`

Listing for the given id

- Listing — Represents a full list of attributes available with Marketcheck for a car
  - `base_ext_color` string — Base exterior color of the car
  - `base_int_color` string — Base interior color of the car
  - `build` Build — Describes the Car specification
    - `antibrake_sys` string — Antibrake system of the car
    - `body_subtype` string — Body subtype of the car
    - `body_type` string — Body type of the car
    - `city_miles` string — City miles of the car
    - `city_mpg` integer — City Mileage in MPG
    - `cylinders` integer — No of cylinders of the car
    - `doors` integer — No of doors of the car
    - `drivetrain` string — Drivetrain of the car
    - `engine` string — Engine of the car
    - `engine_aspiration` string — Engine aspiration of the car
    - `engine_block` string — Engine block of the car
    - `engine_measure` string — Engine block of the car
    - `engine_size` number, double — Engine size of the car
    - `fuel_type` string — Fuel type of the car
    - `highway_miles` string — Highway miles of the car
    - `highway_mpg` integer — Highway Mileage in MPG
    - `made_in` string — Made in of the car
    - `make` string — Car Make
    - `model` string — Car model
    - `opt_seating` string — opt seating of the car
    - `overall_height` string — Overall height of the car
    - `overall_length` string — Overall length of the car
    - `overall_width` string — Overall width of the car
    - `powertrain_type` string — powertrain_type of the car
    - `short_trim` string — Short trim of the car
    - `std_seating` string — Std seating of the car
    - `steering_type` string — Steering type of the car
    - `tank_size` string — Tank size of the car
    - `transmission` string — Transmission of the car
    - `trim` string — Trim of the car
    - `trim_r` string — Trim_r of the car
    - `vehicle_type` string — Vehicle type of the car
    - `year` integer — Year of the Car
  - `carfax_1_owner` boolean — Flag to indicate whether listing is carfax_1_owner
  - `carfax_clean_title` boolean — Flag to indicate whether listing is carfax_clean_title
  - `data_source` string — Data source of the listing
  - `dealer` NestDealer
    - `city` string — City of the dealer
    - `country` string — country of the dealer
    - `county` string — county of the dealer
    - `dealer_type` string — Type of dealer (franchise/independent)
    - `dealership_group_name` string — dealership_group_name of dealer
    - `id` integer — The unique id associated with the dealer in the Marketcheck database
    - `latitude` string — Latutide for the dealer location
    - `longitude` string — Longitude for the dealer location
    - `msa_code` string — msa_code of the dealer
    - `name` string — Name of the dealer
    - `phone` string — Contact no of the dealer
    - `seller_email` string — Contact email of the dealer
    - `state` string — State of the dealer
    - `street` string — Street of the dealer
    - `website` string — Website of the dealer
    - `zip` string — Zip of the dealer
  - `dom` integer — Days on Market value for the car based on current and historical listings found in the Marketcheck database for this car
  - `dom_180` integer — Days on Market value for the car based on current and last 6 month listings found in the Marketcheck database for this car
  - `dom_active` integer — Days on Market value for the car based on current and last 30 days listings found in the Marketcheck database for this car
  - `exterior_color` string — Exterior color of the car
  - `extra` ListingNestExtraAttributes
    - `dealer_added_f` string[] — List of dealer added features available with the car
    - `electronics_f` string[] — List of electronic features available with the car
    - `exterior_f` string[] — List of exterior features available with the car
    - `features` string[] — List of Features available with the car
    - `interior_f` string[] — List of interior features available with the car
    - `options` string[] — Installed Options of the car
    - `safety_f` string[] — List of safety features available with the car
    - `seller_comments` string — Seller comments for the car
    - `standard_f` string[] — List of standard features available with the car
    - `technical_f` string[] — List of technical features available with the car
  - `financing_options` ListingFinance[] — Array of all finance offers for this listing
    - `down_payment` number, double — Down payment for this finance offer
    - `down_payment_percentage` number, double — down payment percentage for this finance offer
    - `estimated_monthly_payment` number, double — estimated monthly payment for this finance offer
    - `loan_apr` number, double — Loan APR for this finance offer
    - `loan_term` integer — Loan term for this finance offer
  - `first_seen_at` integer — Listing first seen at first scraped timestamp
  - `first_seen_at_date` string — Listing first seen at first scraped date
  - `first_seen_at_mc` integer — Listing first seen at first scraped at MC timestamp
  - `first_seen_at_mc_date` string — Listing first seen at first scraped at MC date
  - `first_seen_at_source` integer — Listing first seen at source relisted timestamp
  - `first_seen_at_source_date` string — Listing first seen at source relisted date
  - `heading` string — Listing title as displayed on the source website
  - `id` string — Unique identifier representing a specific listing from the Marketcheck database
  - `interior_color` string — Interior color of the car
  - `inventory_type` string — Inventory type of car
  - `is_certified` integer — Certified car
  - `last_seen_at` integer — Listing last seen at (most recent) timestamp
  - `last_seen_at_date` string — Listing last seen at (most recent) date
  - `leasing_options` ListingLease[] — Array of all finance offers for this listing
    - `down_payment` number, double — Down payment for this lease offer
    - `estimated_monthly_payment` number, double — estimated monthly payment for this lease offer
    - `lease_term` integer — Lease term for this lease offer
  - `media` ListingNestMedia
    - `photo_links` string[] — A list of photo urls for the car
    - `photo_links_cached` string[] — A list of cached photo urls for the car
  - `miles` integer — Odometer reading / reported miles usage for the car
  - `msrp` integer — MSRP for the car
  - `price` integer — Asking price for the car
  - `price_change_percent` number, double — Percentage difference between the cars's current price and ref_price i.e. last reported price
  - `rank` integer — Relative rank of the listing determined by ranking service
  - `ref_miles` string — Last Odometer reading / reported miles usage for the car. If the asking miles value is not or is available then the last_miles could perhaps be used. last_miles is the miles for the car listed on the source website as of last_miles_dt date
  - `ref_miles_dt` integer — The date at which the last miles was reported online. This is earlier to last_seen_date
  - `ref_price` string — Last reported price for the car. If the asking price value is not or is available then the last_price could perhaps be used. last_price is the price for the car listed on the source website as of last_price_dt date
  - `ref_price_dt` integer — The date at which the last price was reported online. This is earlier to last_seen_date
  - `score` number, double — Score of the ranked listing as per the ranking criteria determined by ranking service
  - `scraped_at` integer — Listing last seen at date timestamp
  - `scraped_at_date` string — Listing last seen at date
  - `seller_type` string — Seller type for the car
  - `source` string — Source domain of the listing
  - `stock_no` string — Stock number of car in dealers inventory
  - `vdp_url` string — Vehicle Details Page url of the specific car
  - `vehicle_registration_mark` string — Vehicle Registration Mark of the car
  - `vin` string — VIN for the car

## Other responses

- `default` — Error

---

[API](https://skmtc.net/apigee/apis/marketcheck-cars.md) · [All operations](https://skmtc.net/apigee/apis/marketcheck-cars/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apigee/marketcheck-cars/versions/0a4f106f520a/schema)
