Skip to main content
POST
Price-cut candidates
Returns a ranked list of the dealership’s aged + over-market units with a recommended move per unit. Scope required: market_data:read
Plan required: Unlimited

Authorizations

X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Body

application/json
make
string
model
string
trim
string
year_min
integer
Required range: 1980 <= x <= 2100
year_max
integer
Required range: 1980 <= x <= 2100
car_type
enum<string>
Available options:
new,
used,
certified
zip
string
Required string length: 3 - 12
state
string
Required string length: 2
radius_miles
integer
Required range: 1 <= x <= 500
sample_size
integer
Required range: 1 <= x <= 10
price_min
integer
Required range: x >= 0
price_max
integer
Required range: x >= 0
miles_min
integer
Required range: x >= 0
miles_max
integer
Required range: x >= 0
vehicle_type
enum<string>
Available options:
new,
used,
certified
min_days_on_lot
integer
Required range: 1 <= x <= 1000
limit
integer
Required range: 1 <= x <= 25

Response

Ranked price-cut candidates

data
object

Live market payload (shape varies by endpoint)

Last modified on July 26, 2026