# Is the retail market absorbing the vehicles on your run list?

Canonical URL: https://ai.marketcheck.com/reports/run-list-retail-demand-check

> Run-List Retail Demand Check: For every vehicle on a run list: how many sold at retail in your target states last month, at what price and odometer, how fast, and the lane order.

**Price:** $0.25 per line, with a $2.99 minimum per run (up to 200 lines); a larger run is quoted before it runs. Runs inside Claude or ChatGPT (MCP), or as a shareable hosted web report. Pay per report, no subscription needed.

The retail demand check for an auction run list: paste one vehicle per line (year make model, a trim if you have it, or a 17-character VIN, which is decoded) and one to three target states, and every vehicle gets, per state, the units that left dealer websites in the latest data month, the priced sample, the median asking price at exit, the median odometer and the median days to sell. The list comes back in lane order (fastest clearing first, with the state that clears each fastest), with a segment turn-speed table per state (body types with 50 or more sales ranked by median days to sell) and a demand read: coverage of the list, the deepest demand, the fastest and slowest to clear. From the Sold Summary API: a sale is inferred when a listing leaves a US dealer website, every price is the advertised asking price at exit (never a lane, hammer or negotiated price), and the data runs through the latest complete month, one to two months behind the calendar. Use when an auction, remarketer, wholesaler or dealer asks whether the retail market in the lane's draw states is absorbing the vehicles on a run list, at what price level and how fast, or which units to run first. Do NOT use to rank VINs for one dealer's lot (use Acquisition Fit Report), to find the best-fit rooftop for a unit (use Placement Report), or for a state price map of one nameplate (use Regional Arbitrage Map). State grain only, no ZIP or radius; lines are matched on model year, make and model, every trim together. PRICING: metered at $0.25 per vehicle with retail sales in at least one target state, with a $2.99 minimum, up to 200 lines per run; lines that cannot be read, vehicles with no sales in the target states, and a vehicle pasted more than once (looked up once) are not billed. A list that could cost more than $2.99 requires cost confirmation: call first WITHOUT confirm_cost_usd for an up-to quote (this charges nothing and warms the data), then again with confirm_cost_usd set to the quoted cap once the user approves.

## Inputs

### Required
- **lines** (e.g. `2021 Ford F-150 XLT`): One vehicle per line as year make model with an optional trim (e.g. "2021 Ford F-150 XLT"), or a 17-character VIN, which is decoded to its year, make and model. A lot number before the year, or a "ref | vehicle" form, is kept as the line's reference. Up to 200 lines. Metered at $0.25 per vehicle with retail sales in at least one target state, $2.99 minimum.
- **target_states** (e.g. `TX, OK, AR`): One to three US states the lanes draw from, as 2-letter codes separated by commas (e.g. TX, OK, AR). The sold data has state grain only, no ZIP or radius.

### Recommended
- **inventory_type** (e.g. `used`): Which market: used (the default), new, or certified pre-owned.

### Optional
- **months** (e.g. `1`): Whole months to count units over, ending at the latest data month: 1 by default (the latest month), up to 3. The medians always describe the latest month with 5 or more priced sales.
- **confirm_cost_usd** (e.g. `10`): Only for a list that could cost more than the $2.99 floor (12 lines or more). After quoting the user the up-to cap and getting approval, call again with this set to the quoted cap. Charged only for vehicles with retail sales, never above the cap. Leave empty on the first (quote) call.

## Questions

**What do I paste?** One vehicle per line: year make model with an optional trim (2021 Ford F-150 XLT), or a 17-character VIN, which is decoded to its year, make and model. A lot number before the year, or a "ref | vehicle" form, is kept as the line's reference. Up to 200 lines, and one to three target states as 2-letter codes.

**Where does the demand figure come from?** The Sold Summary API: a sale is inferred when a listing leaves a US dealer website, and every price is the advertised asking price at that moment, never a lane, hammer or negotiated price. Auction transactions are not in the data, which is what makes it a retail absorption check. The data runs through the latest complete month.

**What does each line get?** Per target state: the units that left dealer websites in the latest month, the priced sample (n), the median asking price at exit, the median odometer and the median days to sell. Lines are matched on model year, make and model, every trim together; a line with no sales in a state says so.

**What is the lane order?** The vehicles with sales, fastest clearing first, each with the target state where its median days to sell is lowest among states with at least 5 priced sales, its units and median asking price there, and the units across every target state. A segment table per state ranks body types with 50 or more sales by days to sell.

**What is not billed?** Lines that cannot be read, vehicles with no retail sales in the target states, and a vehicle pasted more than once (it is looked up once). The quote states the up-to cap; the charge is only for vehicles with sales.

**What does it cost?** $0.25 per vehicle with retail sales in at least one target state, with a $2.99 minimum, up to 200 lines per run. A list of 12 or more lines is quoted first, charging nothing. Connect the MarketCheck AI Desk to Claude or ChatGPT once and ask in plain English, or run it from this website. You pay per report from a credit balance; no subscription is needed.

## Data semantics

Every price is a **listed (asking) price**, not a transacted sale price. "Recently off-market" comps show a vehicle's last list price (a sold proxy). The ML "MarketCheck Price" predicts the off-market exit price: what comparable cars were last listed at right before they left the market. It is a listing price, not a sale price.

## How to run

Connect MarketCheck to Claude or ChatGPT at https://ai.marketcheck.com/install, then ask in plain English. Or open the report page and run it.

[Open the Run-List Retail Demand Check](https://ai.marketcheck.com/reports/run-list-retail-demand-check) · [All reports](https://ai.marketcheck.com/) · [llms.txt](https://ai.marketcheck.com/llms.txt)
