Home / Derivative APIs

Derivative APIs

Composite endpoints that orchestrate multiple MarketCheck API calls into single, purpose-built responses.

Get Free API Key Core API Docs ↗

Overview

These derivative APIs are hosted at https://apps.marketcheck.com/api/proxy/{endpoint} and wrap the underlying MarketCheck APIs into higher-level, use-case-specific endpoints. Each endpoint orchestrates multiple API calls (VIN decode, price prediction, search, history, etc.) and returns a unified response.

Important: Reference Implementation — Not Under Long-Term Support

These derivative endpoints are provided as reference implementations to demonstrate how multiple MarketCheck API calls can be composed into higher-level, use-case-specific workflows. They are not covered under the same Long-Term Support (LTS) commitments as the standard MarketCheck API platform and may change without notice.

For production systems, we recommend one of the following approaches:

  • Build your own orchestration layer using the core MarketCheck APIs directly. These endpoints serve as working examples of how to structure those calls.
  • Request LTS elevation — if a specific derivative endpoint meets a critical need, contact MarketCheck support to discuss promoting it to the standard API platform with full versioning, SLA, and backward-compatibility guarantees.

Authentication: All endpoints require a MarketCheck API key passed in the request body as _auth_mode and _auth_value.

// Example: POST https://apps.marketcheck.com/api/proxy/evaluate-deal
{
  "vin": "1HGCV1F34LA000001",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_MARKETCHECK_API_KEY"
}

Don't have an API key? Sign up free at developers.marketcheck.com

Endpoints (30)

Jump to: Trade-In Estimator · Deal Evaluator · Appraiser Workbench · Claims Valuation · VIN Market Report · Enhanced Car Search · Car Comparison · Market Index · Lot Pricing Scan · Stocking Intelligence · Comparables Explorer · Auction Arbitrage Finder · Loan Application Evaluator · Incentive-Adjusted Deal Evaluator · Insurance Premium Benchmark · Market Briefing · Portfolio Stress Test · Dealer Conquest Analysis · Multi-OEM Incentive Scanner · VIN History Trace · Pricing Report · OEM Incentives Explorer · Wholesale Vehicle Router · Dealer Fit Scorer · Market Anomaly Detector · Fleet Lifecycle Manager · Rental Fleet Valuator · UK Car Search · UK Market Trends · UK Lot Pricing

POST /api/proxy/estimate-trade-in

Trade-In Estimator

Estimates trade-in, private party, and instant cash values for a vehicle. Combines VIN decoding, retail and wholesale price predictions, and recent sold comparables into a single response.

Underlying MarketCheck APIs

VIN DecodePrice Prediction (franchise)Price Prediction (independent)Search Recent/Sold

Parameters

NameTypeRequiredDescription
vinstringYes17-character VIN
milesnumberNoCurrent mileage
zipstringNoZIP code for regional pricing

Example Request

POST https://apps.marketcheck.com/api/proxy/estimate-trade-in
Content-Type: application/json

{
  "vin": "5YJSA1DG9DFP14705",
  "miles": 45000,
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2013,
    "make": "Tesla",
    "model": "Model S",
    "trim": "Performance",
    "body_type": "Sedan",
    "engine": "Electric",
    "transmission": "1-Speed Automatic",
    "drivetrain": "RWD",
    "fuel_type": "Electric",
    "msrp": 87400,
    "exterior_color": "Red"
  },
  "retail": {
    "predicted_price": 28500,
    "price_range": {
      "low": 25200,
      "high": 31800
    },
    "confidence_score": 0.87,
    "comparables_count": 18
  },
  "wholesale": {
    "predicted_price": 24200,
    "price_range": {
      "low": 21500,
      "high": 26900
    },
    "confidence_score": 0.82,
    "comparables_count": 12
  },
  "soldComps": {
    "num_found": 42,
    "stats": {
      "price": {
        "mean": 26800,
        "min": 19500,
        "max": 34200,
        "std": 3150
      }
    },
    "listings": [
      {
        "vin": "5YJSA1E2XEF123456",
        "year": 2014,
        "make": "Tesla",
        "model": "Model S",
        "price": 27500,
        "miles": 52000,
        "sold_date": "2024-11-15"
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/evaluate-deal

Deal Evaluator

Comprehensive deal evaluation. Decodes VIN, predicts fair market price, retrieves listing history, and finds comparable active listings to determine if a deal is good, fair, or overpriced.

Underlying MarketCheck APIs

VIN DecodePrice PredictionCar HistorySearch Active

Parameters

NameTypeRequiredDescription
vinstringYes17-character VIN
zipstringNoBuyer's ZIP code
milesnumberNoCurrent mileage

Example Request

POST https://apps.marketcheck.com/api/proxy/evaluate-deal
Content-Type: application/json

{
  "vin": "1HGCV1F34LA000001",
  "zip": "60601",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2020,
    "make": "Honda",
    "model": "Accord",
    "trim": "Sport 1.5T",
    "body_type": "Sedan",
    "engine": "1.5L Turbo I4",
    "transmission": "CVT",
    "drivetrain": "FWD",
    "fuel_type": "Gasoline",
    "msrp": 28400
  },
  "prediction": {
    "predicted_price": 24500,
    "price_range": {
      "low": 22100,
      "high": 26900
    },
    "confidence_score": 0.91,
    "comparables_count": 24
  },
  "activeComps": {
    "num_found": 156,
    "stats": {
      "price": {
        "mean": 25200,
        "min": 18900,
        "max": 31500
      },
      "miles": {
        "mean": 38200
      },
      "dom": {
        "mean": 28
      }
    },
    "listings": [
      {
        "vin": "1HGCV1F38MA112233",
        "year": 2021,
        "make": "Honda",
        "model": "Accord",
        "trim": "Sport",
        "price": 24800,
        "miles": 35200,
        "dealer": {
          "name": "Honda of Chicago",
          "city": "Chicago",
          "state": "IL"
        }
      }
    ]
  },
  "history": {
    "listings": [
      {
        "price": 27500,
        "miles": 15000,
        "first_seen": "2022-03-10",
        "last_seen": "2022-05-20",
        "dealer": "AutoNation Honda"
      },
      {
        "price": 25900,
        "miles": 28000,
        "first_seen": "2023-08-15",
        "last_seen": "2024-01-10",
        "dealer": "CarMax Chicago"
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/appraiser-workbench

Appraiser Workbench

Full vehicle appraisal with retail and wholesale valuations, active and sold comparables (25 each), listing history, and VIN-decoded specs. The most comprehensive single-call valuation endpoint.

Underlying MarketCheck APIs

VIN DecodePrice Prediction (franchise)Price Prediction (independent)Car HistorySearch ActiveSearch Recent/Sold

Parameters

NameTypeRequiredDescription
vinstringYes17-character VIN
milesnumberNoMileage
zipstringNoZIP code

Example Request

POST https://apps.marketcheck.com/api/proxy/appraiser-workbench
Content-Type: application/json

{
  "vin": "WBA7E2C51JG123456",
  "miles": 35000,
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2018,
    "make": "BMW",
    "model": "7 Series",
    "trim": "740i",
    "body_type": "Sedan",
    "engine": "3.0L Turbo I6",
    "transmission": "8-Speed Automatic",
    "drivetrain": "RWD",
    "fuel_type": "Gasoline",
    "msrp": 83650,
    "city_mpg": 21,
    "highway_mpg": 29
  },
  "retail": {
    "predicted_price": 38900,
    "price_range": {
      "low": 35400,
      "high": 42400
    },
    "confidence_score": 0.84,
    "comparables_count": 14
  },
  "wholesale": {
    "predicted_price": 33200,
    "price_range": {
      "low": 30100,
      "high": 36300
    },
    "confidence_score": 0.79
  },
  "activeComps": {
    "num_found": 89,
    "stats": {
      "price": {
        "mean": 40200,
        "min": 28500,
        "max": 55000
      },
      "miles": {
        "mean": 42000
      },
      "dom": {
        "mean": 35
      }
    },
    "listings": [
      {
        "vin": "WBA7F2C58JG445566",
        "year": 2018,
        "make": "BMW",
        "model": "7 Series",
        "price": 37900,
        "miles": 38500,
        "dealer": {
          "name": "BMW Beverly Hills",
          "city": "Beverly Hills",
          "state": "CA"
        }
      }
    ]
  },
  "soldComps": {
    "num_found": 45,
    "stats": {
      "price": {
        "mean": 36800,
        "min": 26000,
        "max": 48500
      }
    }
  },
  "history": {
    "listings": [
      {
        "price": 52900,
        "miles": 12000,
        "first_seen": "2020-06-01",
        "dealer": "BMW of Manhattan"
      },
      {
        "price": 41500,
        "miles": 28000,
        "first_seen": "2022-11-10",
        "dealer": "Carvana"
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/claims-valuation

Claims Valuation

Insurance claims valuation with fair market value, sold comparables, regional pricing data, and replacement vehicle options. Everything needed for total-loss determination.

Underlying MarketCheck APIs

VIN DecodePrice PredictionSearch Recent/SoldSold Vehicle SummarySearch Active

Parameters

NameTypeRequiredDescription
vinstringYesClaimed vehicle VIN
milesnumberNoMileage at time of loss
zipstringYesClaim location ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/claims-valuation
Content-Type: application/json

{
  "vin": "5YJSA1DG9DFP14705",
  "miles": 50000,
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2013,
    "make": "Tesla",
    "model": "Model S",
    "trim": "Performance",
    "body_type": "Sedan",
    "engine": "Electric",
    "fuel_type": "Electric",
    "msrp": 87400
  },
  "fmvResult": {
    "predicted_price": 27500,
    "price_range": {
      "low": 24000,
      "high": 31000
    },
    "confidence_score": 0.85
  },
  "soldComps": {
    "num_found": 38,
    "stats": {
      "price": {
        "mean": 26200,
        "min": 18500,
        "max": 33800
      }
    },
    "listings": [
      {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "price": 25800,
        "miles": 55000,
        "sold_date": "2024-10-22"
      }
    ]
  },
  "regionalData": {
    "rankings": [
      {
        "state": "CA",
        "average_sale_price": 28900,
        "sold_count": 142
      },
      {
        "state": "FL",
        "average_sale_price": 26100,
        "sold_count": 67
      }
    ]
  },
  "replacements": {
    "num_found": 12,
    "listings": [
      {
        "year": 2014,
        "make": "Tesla",
        "model": "Model S",
        "price": 26500,
        "miles": 48000,
        "dealer": {
          "name": "Tesla Beverly Hills",
          "city": "Beverly Hills",
          "state": "CA"
        }
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/generate-vin-market-report

VIN Market Report

Complete market intelligence report for a single VIN. Includes specs, pricing (retail + wholesale), market position, comparables, history, and available incentives. Designed for embedding as a widget.

Underlying MarketCheck APIs

VIN DecodePrice Prediction (franchise)Price Prediction (independent)Car HistorySearch ActiveSearch Recent/SoldSold Vehicle SummaryOEM Incentives

Parameters

NameTypeRequiredDescription
vinstringYes17-character VIN
milesnumberNoMileage
zipstringNoZIP code

Example Request

POST https://apps.marketcheck.com/api/proxy/generate-vin-market-report
Content-Type: application/json

{
  "vin": "1HGCV1F34LA000001",
  "zip": "60601",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2020,
    "make": "Honda",
    "model": "Accord",
    "trim": "Sport 1.5T",
    "body_type": "Sedan",
    "engine": "1.5L Turbo I4",
    "drivetrain": "FWD",
    "fuel_type": "Gasoline",
    "msrp": 28400
  },
  "retail": {
    "predicted_price": 24500,
    "price_range": {
      "low": 22100,
      "high": 26900
    },
    "confidence_score": 0.91
  },
  "wholesale": {
    "predicted_price": 20800,
    "price_range": {
      "low": 18500,
      "high": 23100
    }
  },
  "history": {
    "listings": [
      {
        "price": 27500,
        "miles": 15000,
        "first_seen": "2022-03-10",
        "dealer": "AutoNation Honda"
      }
    ]
  },
  "activeComps": {
    "num_found": 156,
    "stats": {
      "price": {
        "mean": 25200
      },
      "miles": {
        "mean": 38200
      }
    }
  },
  "soldComps": {
    "num_found": 89,
    "stats": {
      "price": {
        "mean": 23800
      }
    }
  },
  "soldSummary": {
    "rankings": [
      {
        "make": "Honda",
        "model": "Accord",
        "sold_count": 4520,
        "average_sale_price": 24100
      }
    ]
  },
  "incentives": [
    {
      "title": "Honda APR Special",
      "type": "apr",
      "value": "2.9% for 60 months",
      "expires": "2025-03-31"
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/search-cars

Enhanced Car Search

Active inventory search with pre-configured stats, facets, dealer objects, build objects, and photos. A convenience wrapper over the base search that returns a richer response.

Underlying MarketCheck APIs

Search Active

Parameters

NameTypeRequiredDescription
makesstringNoComma-separated makes
bodyTypesstringNoBody types
yearRangestringNoYear range
priceRangestringNoPrice range
zipstringNoZIP code
radiusnumberNoMiles
rowsnumberNoResults (default 12)

Example Request

POST https://apps.marketcheck.com/api/proxy/search-cars
Content-Type: application/json

{
  "makes": "Toyota",
  "zip": "90210",
  "radius": 50,
  "rows": 10,
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "num_found": 4521,
  "listings": [
    {
      "vin": "4T1BF1FK5HU123456",
      "year": 2017,
      "make": "Toyota",
      "model": "Camry",
      "trim": "SE",
      "price": 18900,
      "miles": 62000,
      "body_type": "Sedan",
      "fuel_type": "Gasoline",
      "days_on_market": 22,
      "dealer": {
        "name": "Toyota Santa Monica",
        "city": "Santa Monica",
        "state": "CA"
      }
    },
    {
      "vin": "2T1BURHE8JC654321",
      "year": 2018,
      "make": "Toyota",
      "model": "Corolla",
      "trim": "LE",
      "price": 16500,
      "miles": 48000,
      "body_type": "Sedan",
      "dealer": {
        "name": "AutoNation Toyota",
        "city": "Los Angeles",
        "state": "CA"
      }
    }
  ],
  "stats": {
    "price": {
      "mean": 32400,
      "min": 8900,
      "max": 72000,
      "std": 12500
    },
    "miles": {
      "mean": 45200,
      "min": 5,
      "max": 185000
    }
  },
  "facets": {
    "make": [
      {
        "value": "Toyota",
        "count": 4521
      }
    ],
    "body_type": [
      {
        "value": "SUV",
        "count": 1823
      },
      {
        "value": "Sedan",
        "count": 1205
      },
      {
        "value": "Truck",
        "count": 891
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/compare-cars

Car Comparison

Side-by-side comparison of 2+ vehicles. Decodes each VIN for full specs and predicts market prices for each.

Underlying MarketCheck APIs

VIN Decode (per VIN)Price Prediction (per VIN)

Parameters

NameTypeRequiredDescription
vinsstring[]YesArray of VINs to compare
zipstringNoZIP for pricing context

Example Request

POST https://apps.marketcheck.com/api/proxy/compare-cars
Content-Type: application/json

{
  "vins": [
    "1HGCV1F34LA000001",
    "5YJSA1DG9DFP14705"
  ],
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "comparisons": [
    {
      "vin": "1HGCV1F34LA000001",
      "decode": {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "trim": "Sport 1.5T",
        "engine": "1.5L Turbo I4",
        "msrp": 28400
      },
      "price": {
        "predicted_price": 24500,
        "price_range": {
          "low": 22100,
          "high": 26900
        }
      }
    },
    {
      "vin": "5YJSA1DG9DFP14705",
      "decode": {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "trim": "Performance",
        "engine": "Electric",
        "msrp": 87400
      },
      "price": {
        "predicted_price": 28500,
        "price_range": {
          "low": 25200,
          "high": 31800
        }
      }
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/get-market-index

Market Index

Used car market index data. Returns top brands by volume and price, plus body type segment analysis. Filterable by state.

Underlying MarketCheck APIs

Sold Vehicle Summary (by make)Sold Vehicle Summary (by body type)

Parameters

NameTypeRequiredDescription
statestringNoState abbreviation

Example Request

POST https://apps.marketcheck.com/api/proxy/get-market-index
Content-Type: application/json

{
  "state": "CA",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "summary": {
    "rankings": [
      {
        "make": "Toyota",
        "sold_count": 18420,
        "average_sale_price": 29800
      },
      {
        "make": "Honda",
        "sold_count": 12350,
        "average_sale_price": 26400
      },
      {
        "make": "Ford",
        "sold_count": 11200,
        "average_sale_price": 31500
      },
      {
        "make": "Chevrolet",
        "sold_count": 9800,
        "average_sale_price": 28900
      },
      {
        "make": "BMW",
        "sold_count": 6540,
        "average_sale_price": 38200
      }
    ]
  },
  "segments": {
    "rankings": [
      {
        "body_type": "SUV",
        "sold_count": 34500,
        "average_sale_price": 33200
      },
      {
        "body_type": "Sedan",
        "sold_count": 22100,
        "average_sale_price": 25600
      },
      {
        "body_type": "Truck",
        "sold_count": 15800,
        "average_sale_price": 38500
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/scan-lot-pricing

Lot Pricing Scan

Full dealer lot inventory with market pricing comparison and demand hot list.

Underlying MarketCheck APIs

Search Active (dealer inventory)Sold Vehicle Summary (hot list)

Parameters

NameTypeRequiredDescription
dealerIdstringYesDealer ID
statestringYesState for demand data

Example Request

POST https://apps.marketcheck.com/api/proxy/scan-lot-pricing
Content-Type: application/json

{
  "dealerId": "abc123",
  "state": "TX",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "inventory": {
    "num_found": 87,
    "listings": [
      {
        "vin": "5TFAX5GN2LX123456",
        "year": 2020,
        "make": "Toyota",
        "model": "Tundra",
        "price": 38900,
        "miles": 42000,
        "days_on_market": 18
      },
      {
        "vin": "1G1YY22G965112233",
        "year": 2019,
        "make": "Chevrolet",
        "model": "Corvette",
        "price": 48500,
        "miles": 22000,
        "days_on_market": 45
      }
    ],
    "stats": {
      "price": {
        "mean": 31200
      },
      "miles": {
        "mean": 38500
      },
      "dom": {
        "mean": 32
      }
    }
  },
  "hotList": {
    "rankings": [
      {
        "make": "Toyota",
        "model": "RAV4",
        "sold_count": 890,
        "average_days_on_market": 18
      },
      {
        "make": "Honda",
        "model": "CR-V",
        "sold_count": 720,
        "average_days_on_market": 21
      },
      {
        "make": "Ford",
        "model": "F-150",
        "sold_count": 1150,
        "average_days_on_market": 15
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/stocking-intelligence

Stocking Intelligence

Market demand data by make/model and body type for a state. Helps dealers decide what to stock.

Underlying MarketCheck APIs

Sold Vehicle Summary (by make/model)Sold Vehicle Summary (by body type)

Parameters

NameTypeRequiredDescription
statestringYesState abbreviation

Example Request

POST https://apps.marketcheck.com/api/proxy/stocking-intelligence
Content-Type: application/json

{
  "state": "TX",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "demandData": {
    "rankings": [
      {
        "make": "Ford",
        "model": "F-150",
        "sold_count": 3250
      },
      {
        "make": "Toyota",
        "model": "RAV4",
        "sold_count": 1890
      },
      {
        "make": "Chevrolet",
        "model": "Silverado 1500",
        "sold_count": 2810
      },
      {
        "make": "Honda",
        "model": "CR-V",
        "sold_count": 1420
      },
      {
        "make": "Toyota",
        "model": "Camry",
        "sold_count": 1380
      }
    ]
  },
  "segmentDemand": {
    "rankings": [
      {
        "body_type": "Truck",
        "sold_count": 12500,
        "average_sale_price": 38200,
        "average_days_on_market": 19
      },
      {
        "body_type": "SUV",
        "sold_count": 15800,
        "average_sale_price": 32400,
        "average_days_on_market": 24
      },
      {
        "body_type": "Sedan",
        "sold_count": 8900,
        "average_sale_price": 24100,
        "average_days_on_market": 28
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/comparables-explorer

Comparables Explorer

Flexible comparable search by VIN or make/model/year. Returns both active and sold comparables with optional price prediction.

Underlying MarketCheck APIs

VIN Decode (optional)Search ActiveSearch Recent/SoldPrice Prediction (optional)

Parameters

NameTypeRequiredDescription
vinstringNoVIN (optional)
makestringNoMake
modelstringNoModel
yearstringNoYear
zipstringNoZIP
radiusnumberNoRadius (default 100)

Example Request

POST https://apps.marketcheck.com/api/proxy/comparables-explorer
Content-Type: application/json

{
  "make": "Toyota",
  "model": "Camry",
  "year": "2022",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": null,
  "activeComps": {
    "num_found": 234,
    "stats": {
      "price": {
        "mean": 26800,
        "min": 21500,
        "max": 33200
      },
      "miles": {
        "mean": 32400
      },
      "dom": {
        "mean": 26
      }
    },
    "listings": [
      {
        "vin": "4T1C11AK7NU123456",
        "year": 2022,
        "make": "Toyota",
        "model": "Camry",
        "trim": "SE",
        "price": 25900,
        "miles": 28000,
        "dealer": {
          "name": "Toyota of Hollywood",
          "city": "Hollywood",
          "state": "CA"
        }
      }
    ]
  },
  "soldComps": {
    "num_found": 178,
    "stats": {
      "price": {
        "mean": 25200,
        "min": 19800,
        "max": 31500
      }
    },
    "listings": [
      {
        "year": 2022,
        "make": "Toyota",
        "model": "Camry",
        "price": 24800,
        "miles": 35000,
        "sold_date": "2024-11-01"
      }
    ]
  },
  "prediction": null
}

View app that uses this endpoint →

POST /api/proxy/find-auction-arbitrage

Auction Arbitrage Finder

Calculates wholesale-to-retail spread for each VIN. Predicts both franchise (retail) and independent (wholesale) prices to identify profit opportunities.

Underlying MarketCheck APIs

VIN Decode (per VIN)Price Prediction - franchise (per VIN)Price Prediction - independent (per VIN)

Parameters

NameTypeRequiredDescription
vinsstringYesComma-separated VINs
zipstringYesMarket ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/find-auction-arbitrage
Content-Type: application/json

{
  "vins": "5YJSA1DG9DFP14705,1HGCV1F34LA000001",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "results": [
    {
      "vin": "5YJSA1DG9DFP14705",
      "decode": {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "trim": "Performance"
      },
      "retail": {
        "predicted_price": 28500
      },
      "wholesale": {
        "predicted_price": 24200
      },
      "spread": 4300,
      "spreadPct": 15.1
    },
    {
      "vin": "1HGCV1F34LA000001",
      "decode": {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "trim": "Sport 1.5T"
      },
      "retail": {
        "predicted_price": 24500
      },
      "wholesale": {
        "predicted_price": 20800
      },
      "spread": 3700,
      "spreadPct": 15.1
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/evaluate-loan-application

Loan Application Evaluator

Collateral assessment for auto loan underwriting. Returns retail and wholesale valuations, depreciation history, and sold comparables.

Underlying MarketCheck APIs

VIN DecodePrice Prediction (franchise)Price Prediction (independent)Car HistorySearch Recent/Sold

Parameters

NameTypeRequiredDescription
vinstringYesVehicle VIN
milesnumberNoMileage
zipstringNoBorrower ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/evaluate-loan-application
Content-Type: application/json

{
  "vin": "WBA7E2C51JG123456",
  "miles": 30000,
  "zip": "60601",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2018,
    "make": "BMW",
    "model": "7 Series",
    "trim": "740i",
    "body_type": "Sedan",
    "engine": "3.0L Turbo I6",
    "msrp": 83650
  },
  "retail": {
    "predicted_price": 38900,
    "price_range": {
      "low": 35400,
      "high": 42400
    },
    "confidence_score": 0.84
  },
  "wholesale": {
    "predicted_price": 33200,
    "price_range": {
      "low": 30100,
      "high": 36300
    }
  },
  "history": {
    "listings": [
      {
        "price": 52900,
        "miles": 12000,
        "first_seen": "2020-06-01",
        "dealer": "BMW of Manhattan"
      },
      {
        "price": 41500,
        "miles": 28000,
        "first_seen": "2022-11-10",
        "dealer": "Carvana"
      }
    ]
  },
  "soldComps": {
    "num_found": 45,
    "stats": {
      "price": {
        "mean": 36800,
        "min": 26000,
        "max": 48500
      }
    }
  }
}

View app that uses this endpoint →

POST /api/proxy/evaluate-incentive-deal

Incentive-Adjusted Deal Evaluator

Evaluates a deal with OEM incentives. Returns vehicle specs, predicted price, all available incentives, and comparable listings.

Underlying MarketCheck APIs

VIN DecodePrice PredictionOEM IncentivesSearch Active

Parameters

NameTypeRequiredDescription
vinstringYesVIN
milesnumberNoMileage
zipstringYesZIP for incentives

Example Request

POST https://apps.marketcheck.com/api/proxy/evaluate-incentive-deal
Content-Type: application/json

{
  "vin": "1HGCV1F34LA000001",
  "zip": "60601",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2020,
    "make": "Honda",
    "model": "Accord",
    "trim": "Sport 1.5T",
    "msrp": 28400
  },
  "prediction": {
    "predicted_price": 24500,
    "price_range": {
      "low": 22100,
      "high": 26900
    }
  },
  "incentives": [
    {
      "title": "Honda Loyalty Bonus",
      "type": "cash",
      "value": "$500 cash back",
      "eligible": true
    },
    {
      "title": "Honda APR Special",
      "type": "apr",
      "value": "2.9% for 60 months",
      "eligible": true
    }
  ],
  "activeComps": {
    "num_found": 78,
    "stats": {
      "price": {
        "mean": 25200
      }
    },
    "listings": [
      {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "price": 23900,
        "miles": 41000
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/benchmark-insurance-premiums

Insurance Premium Benchmark

Market-level analysis by body type, fuel type, and state for insurance premium setting.

Underlying MarketCheck APIs

Sold Vehicle Summary (body type)Sold Vehicle Summary (body type + fuel type)Sold Vehicle Summary (state)

No additional parameters required.

Example Request

POST https://apps.marketcheck.com/api/proxy/benchmark-insurance-premiums
Content-Type: application/json

{
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "byBodyType": {
    "rankings": [
      {
        "body_type": "SUV",
        "sold_count": 245000,
        "average_sale_price": 33200
      },
      {
        "body_type": "Sedan",
        "sold_count": 182000,
        "average_sale_price": 25600
      },
      {
        "body_type": "Truck",
        "sold_count": 156000,
        "average_sale_price": 38500
      }
    ]
  },
  "byFuelType": {
    "rankings": [
      {
        "body_type": "SUV",
        "fuel_type_category": "Gas",
        "sold_count": 198000,
        "average_sale_price": 34100
      },
      {
        "body_type": "SUV",
        "fuel_type_category": "Electric",
        "sold_count": 18500,
        "average_sale_price": 42800
      },
      {
        "body_type": "SUV",
        "fuel_type_category": "Hybrid",
        "sold_count": 28500,
        "average_sale_price": 36200
      }
    ]
  },
  "byState": {
    "rankings": [
      {
        "state": "CA",
        "sold_count": 89000,
        "average_sale_price": 32400
      },
      {
        "state": "TX",
        "sold_count": 78000,
        "average_sale_price": 31200
      },
      {
        "state": "FL",
        "sold_count": 65000,
        "average_sale_price": 29800
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/generate-market-briefing

Market Briefing

Executive market summary: top brands, body type analysis, and regional price leaders.

Underlying MarketCheck APIs

Sold Vehicle Summary (by make)Sold Vehicle Summary (by body type)Sold Vehicle Summary (by state)

No additional parameters required.

Example Request

POST https://apps.marketcheck.com/api/proxy/generate-market-briefing
Content-Type: application/json

{
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "byMake": {
    "rankings": [
      {
        "make": "Toyota",
        "sold_count": 142000,
        "average_sale_price": 29800
      },
      {
        "make": "Ford",
        "sold_count": 128000,
        "average_sale_price": 33500
      },
      {
        "make": "Chevrolet",
        "sold_count": 115000,
        "average_sale_price": 30200
      },
      {
        "make": "Honda",
        "sold_count": 98000,
        "average_sale_price": 26400
      },
      {
        "make": "Hyundai",
        "sold_count": 72000,
        "average_sale_price": 24800
      }
    ]
  },
  "byBodyType": {
    "rankings": [
      {
        "body_type": "SUV",
        "sold_count": 245000,
        "average_sale_price": 33200
      },
      {
        "body_type": "Sedan",
        "sold_count": 182000,
        "average_sale_price": 25600
      },
      {
        "body_type": "Truck",
        "sold_count": 156000,
        "average_sale_price": 38500
      }
    ]
  },
  "byState": {
    "rankings": [
      {
        "state": "CA",
        "average_sale_price": 32400
      },
      {
        "state": "NY",
        "average_sale_price": 30100
      },
      {
        "state": "TX",
        "average_sale_price": 31200
      },
      {
        "state": "FL",
        "average_sale_price": 29800
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/stress-test-portfolio

Portfolio Stress Test

Batch VIN valuation for portfolio stress testing. Decodes and prices each vehicle.

Underlying MarketCheck APIs

VIN Decode (per VIN)Price Prediction (per VIN)

Parameters

NameTypeRequiredDescription
vinsstringYesComma-separated VINs
zipstringYesMarket ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/stress-test-portfolio
Content-Type: application/json

{
  "vins": "5YJSA1DG9DFP14705,WBA7E2C51JG123456",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "results": [
    {
      "vin": "5YJSA1DG9DFP14705",
      "decode": {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "trim": "Performance",
        "msrp": 87400
      },
      "prediction": {
        "predicted_price": 28500,
        "price_range": {
          "low": 25200,
          "high": 31800
        }
      }
    },
    {
      "vin": "WBA7E2C51JG123456",
      "decode": {
        "year": 2018,
        "make": "BMW",
        "model": "7 Series",
        "trim": "740i",
        "msrp": 83650
      },
      "prediction": {
        "predicted_price": 38900,
        "price_range": {
          "low": 35400,
          "high": 42400
        }
      }
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/analyze-dealer-conquest

Dealer Conquest Analysis

Compares dealer inventory against broader market. Identifies inventory gaps and conquest opportunities based on local demand.

Underlying MarketCheck APIs

Search Active (dealer)Search Active (market)Sold Vehicle Summary

Parameters

NameTypeRequiredDescription
dealer_idstringYesYour dealer ID
zipstringYesMarket ZIP
radiusnumberNoMarket radius
statestringYesState

Example Request

POST https://apps.marketcheck.com/api/proxy/analyze-dealer-conquest
Content-Type: application/json

{
  "dealer_id": "abc123",
  "zip": "75201",
  "state": "TX",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "myInventory": {
    "num_found": 87,
    "facets": {
      "make": [
        {
          "value": "Toyota",
          "count": 22
        },
        {
          "value": "Honda",
          "count": 18
        }
      ],
      "body_type": [
        {
          "value": "SUV",
          "count": 35
        },
        {
          "value": "Sedan",
          "count": 28
        }
      ]
    }
  },
  "marketInventory": {
    "num_found": 4520,
    "facets": {
      "make": [
        {
          "value": "Toyota",
          "count": 680
        },
        {
          "value": "Ford",
          "count": 590
        },
        {
          "value": "Chevrolet",
          "count": 520
        }
      ],
      "body_type": [
        {
          "value": "SUV",
          "count": 1800
        },
        {
          "value": "Truck",
          "count": 1200
        }
      ]
    }
  },
  "demand": {
    "rankings": [
      {
        "make": "Ford",
        "model": "F-150",
        "sold_count": 3250
      },
      {
        "make": "Toyota",
        "model": "RAV4",
        "sold_count": 1890
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/find-incentive-deals

Multi-OEM Incentive Scanner

Scans incentives from multiple manufacturers for a ZIP code. Returns all available deals across brands.

Underlying MarketCheck APIs

OEM Incentives (per make)

Parameters

NameTypeRequiredDescription
makesstringNoComma-separated makes (defaults to top 10)
zipstringYesZIP code

Example Request

POST https://apps.marketcheck.com/api/proxy/find-incentive-deals
Content-Type: application/json

{
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "results": [
    {
      "make": "Toyota",
      "data": {
        "incentives": [
          {
            "title": "Toyota Cash Back",
            "value": "$2,000 on RAV4",
            "type": "cash",
            "expires": "2025-03-31"
          }
        ]
      }
    },
    {
      "make": "Honda",
      "data": {
        "incentives": [
          {
            "title": "Honda APR Special",
            "value": "1.9% for 36 months",
            "type": "apr",
            "expires": "2025-04-30"
          }
        ]
      }
    },
    {
      "make": "Ford",
      "data": {
        "incentives": [
          {
            "title": "Ford Bonus Cash",
            "value": "$3,500 on F-150",
            "type": "cash"
          }
        ]
      }
    },
    {
      "make": "Hyundai",
      "data": {
        "incentives": [
          {
            "title": "Hyundai Trade-In Bonus",
            "value": "$1,500 trade-in bonus",
            "type": "cash"
          }
        ]
      }
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/trace-vin-history

VIN History Trace

Full listing timeline with VIN decode and current price prediction.

Underlying MarketCheck APIs

VIN DecodeCar HistoryPrice Prediction

Parameters

NameTypeRequiredDescription
vinstringYes17-character VIN
milesnumberNoMileage
zipstringNoZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/trace-vin-history
Content-Type: application/json

{
  "vin": "5YJSA1DG9DFP14705",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2013,
    "make": "Tesla",
    "model": "Model S",
    "trim": "Performance",
    "body_type": "Sedan",
    "engine": "Electric",
    "msrp": 87400
  },
  "history": {
    "listings": [
      {
        "price": 78500,
        "miles": 1200,
        "first_seen": "2013-12-01",
        "last_seen": "2014-03-15",
        "dealer": "Tesla Palo Alto",
        "status": "sold"
      },
      {
        "price": 54200,
        "miles": 18000,
        "first_seen": "2015-08-20",
        "dealer": "CarMax Burbank",
        "status": "sold"
      },
      {
        "price": 38900,
        "miles": 32000,
        "first_seen": "2018-05-10",
        "dealer": "Shift.com"
      },
      {
        "price": 29500,
        "miles": 45000,
        "first_seen": "2021-01-15",
        "dealer": "Vroom"
      }
    ]
  },
  "prediction": {
    "predicted_price": 28500,
    "price_range": {
      "low": 25200,
      "high": 31800
    },
    "confidence_score": 0.87
  }
}

View app that uses this endpoint →

POST /api/proxy/generate-pricing-report

Pricing Report

Shareable pricing report: VIN specs, predicted price, active and sold comparables.

Underlying MarketCheck APIs

VIN DecodePrice PredictionSearch ActiveSearch Recent/Sold

Parameters

NameTypeRequiredDescription
vinstringYesVIN
milesnumberNoMileage
zipstringNoZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/generate-pricing-report
Content-Type: application/json

{
  "vin": "1HGCV1F34LA000001",
  "zip": "60601",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "decode": {
    "year": 2020,
    "make": "Honda",
    "model": "Accord",
    "trim": "Sport 1.5T",
    "body_type": "Sedan",
    "msrp": 28400
  },
  "prediction": {
    "predicted_price": 24500,
    "price_range": {
      "low": 22100,
      "high": 26900
    },
    "confidence_score": 0.91
  },
  "activeComps": {
    "num_found": 156,
    "stats": {
      "price": {
        "mean": 25200,
        "min": 18900,
        "max": 31500
      }
    },
    "listings": [
      {
        "vin": "1HGCV1F38MA112233",
        "year": 2021,
        "make": "Honda",
        "model": "Accord",
        "price": 24800,
        "miles": 35200
      }
    ]
  },
  "soldComps": {
    "num_found": 89,
    "stats": {
      "price": {
        "mean": 23800,
        "min": 17500,
        "max": 29200
      }
    },
    "listings": [
      {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "price": 23200,
        "miles": 42000,
        "sold_date": "2024-10-15"
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/oem-incentives-explorer

OEM Incentives Explorer

Fetches incentives for a make and optionally compares with other brands.

Underlying MarketCheck APIs

OEM IncentivesOEM Incentives (per compare make)

Parameters

NameTypeRequiredDescription
makestringYesPrimary make
modelstringNoModel
zipstringYesZIP
compareMakesstring[]NoBrands to compare

Example Request

POST https://apps.marketcheck.com/api/proxy/oem-incentives-explorer
Content-Type: application/json

{
  "make": "Toyota",
  "zip": "90210",
  "compareMakes": [
    "Honda",
    "Hyundai"
  ],
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "make": "Toyota",
  "incentives": [
    {
      "title": "Toyota Cash Back",
      "value": "$2,000 on RAV4",
      "type": "cash",
      "expires": "2025-03-31"
    },
    {
      "title": "Toyota APR Special",
      "value": "2.9% for 60 months on Camry",
      "type": "apr"
    }
  ],
  "compareIncentives": [
    {
      "make": "Honda",
      "data": {
        "incentives": [
          {
            "title": "Honda Loyalty Bonus",
            "value": "$750",
            "type": "cash"
          }
        ]
      }
    },
    {
      "make": "Hyundai",
      "data": {
        "incentives": [
          {
            "title": "Hyundai Bonus Cash",
            "value": "$2,500 on Tucson",
            "type": "cash"
          }
        ]
      }
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/route-wholesale-vehicles

Wholesale Vehicle Router

Batch VIN decode and pricing for wholesale routing decisions.

Underlying MarketCheck APIs

VIN Decode (per VIN)Price Prediction (per VIN)

Parameters

NameTypeRequiredDescription
vinsstringYesComma-separated VINs
zipstringYesMarket ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/route-wholesale-vehicles
Content-Type: application/json

{
  "vins": "5YJSA1DG9DFP14705,1HGCV1F34LA000001",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "results": [
    {
      "vin": "5YJSA1DG9DFP14705",
      "decode": {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "trim": "Performance"
      },
      "prediction": {
        "predicted_price": 28500
      }
    },
    {
      "vin": "1HGCV1F34LA000001",
      "decode": {
        "year": 2020,
        "make": "Honda",
        "model": "Accord",
        "trim": "Sport 1.5T"
      },
      "prediction": {
        "predicted_price": 24500
      }
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/score-dealer-fit

Dealer Fit Scorer

Score vehicles against a dealer's profile. Batch VIN decode and pricing.

Underlying MarketCheck APIs

VIN Decode (per VIN)Price Prediction (per VIN)

Parameters

NameTypeRequiredDescription
dealer_idstringYesDealer ID
vinsstringYesComma-separated VINs
zipstringYesDealer ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/score-dealer-fit
Content-Type: application/json

{
  "dealer_id": "abc123",
  "vins": "5YJSA1DG9DFP14705",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "dealerId": "abc123",
  "results": [
    {
      "vin": "5YJSA1DG9DFP14705",
      "decode": {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "trim": "Performance",
        "body_type": "Sedan"
      },
      "prediction": {
        "predicted_price": 28500,
        "price_range": {
          "low": 25200,
          "high": 31800
        }
      }
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/detect-market-anomalies

Market Anomaly Detector

Find pricing outliers in active inventory for a make/model.

Underlying MarketCheck APIs

Search Active

Parameters

NameTypeRequiredDescription
makestringYesMake
modelstringYesModel
yearstringNoYear
statestringNoState

Example Request

POST https://apps.marketcheck.com/api/proxy/detect-market-anomalies
Content-Type: application/json

{
  "make": "Tesla",
  "model": "Model 3",
  "state": "CA",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "results": {
    "num_found": 450,
    "listings": [
      {
        "vin": "5YJ3E1EA2LF123456",
        "year": 2020,
        "make": "Tesla",
        "model": "Model 3",
        "trim": "Standard Range Plus",
        "price": 22900,
        "miles": 48000,
        "days_on_market": 5,
        "dealer": {
          "name": "Tesla Fremont",
          "state": "CA"
        },
        "anomaly": "underpriced"
      },
      {
        "vin": "5YJ3E1EB8NF654321",
        "year": 2022,
        "make": "Tesla",
        "model": "Model 3",
        "trim": "Long Range",
        "price": 55800,
        "miles": 12000,
        "days_on_market": 90,
        "dealer": {
          "name": "Private Seller",
          "state": "CA"
        },
        "anomaly": "overpriced"
      }
    ],
    "stats": {
      "price": {
        "mean": 31200,
        "min": 18500,
        "max": 55800,
        "std": 6800
      }
    }
  }
}

View app that uses this endpoint →

POST /api/proxy/manage-fleet-lifecycle

Fleet Lifecycle Manager

Batch fleet valuation with replacement vehicle recommendations.

Underlying MarketCheck APIs

VIN Decode (per VIN)Price Prediction (per VIN)Search Active (replacements)

Parameters

NameTypeRequiredDescription
vinsstringYesFleet VINs
zipstringYesFleet ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/manage-fleet-lifecycle
Content-Type: application/json

{
  "vins": "5YJSA1DG9DFP14705,WBA7E2C51JG123456",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "results": [
    {
      "vin": "5YJSA1DG9DFP14705",
      "decode": {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "body_type": "Sedan"
      },
      "prediction": {
        "predicted_price": 28500
      },
      "depreciationRate": "8.2% annual"
    },
    {
      "vin": "WBA7E2C51JG123456",
      "decode": {
        "year": 2018,
        "make": "BMW",
        "model": "7 Series",
        "body_type": "Sedan"
      },
      "prediction": {
        "predicted_price": 38900
      },
      "depreciationRate": "12.5% annual"
    }
  ],
  "replacements": {
    "num_found": 25,
    "listings": [
      {
        "year": 2024,
        "make": "Toyota",
        "model": "Camry",
        "price": 28500,
        "miles": 5000
      }
    ]
  }
}

View app that uses this endpoint →

POST /api/proxy/value-rental-fleet

Rental Fleet Valuator

Batch valuation for rental fleet vehicles. Decodes and prices each VIN.

Underlying MarketCheck APIs

VIN Decode (per VIN)Price Prediction (per VIN)

Parameters

NameTypeRequiredDescription
vinsstringYesFleet VINs
zipstringYesFleet ZIP

Example Request

POST https://apps.marketcheck.com/api/proxy/value-rental-fleet
Content-Type: application/json

{
  "vins": "5YJSA1DG9DFP14705",
  "zip": "90210",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "results": [
    {
      "vin": "5YJSA1DG9DFP14705",
      "decode": {
        "year": 2013,
        "make": "Tesla",
        "model": "Model S",
        "trim": "Performance",
        "body_type": "Sedan",
        "fuel_type": "Electric"
      },
      "prediction": {
        "predicted_price": 28500,
        "price_range": {
          "low": 25200,
          "high": 31800
        },
        "confidence_score": 0.87
      },
      "mileageAdjustedValue": 26800,
      "optimalRotationMiles": 60000
    }
  ]
}

View app that uses this endpoint →

POST /api/proxy/search-uk-cars

UK Car Search

Search UK active and recent car listings.

Underlying MarketCheck APIs

UK Active ListingsUK Recent Listings

Parameters

NameTypeRequiredDescription
makestringNoMake
modelstringNoModel
postal_codestringNoUK postal code
radiusnumberNoRadius
rowsnumberNoResults (default 25)

Example Request

POST https://apps.marketcheck.com/api/proxy/search-uk-cars
Content-Type: application/json

{
  "make": "BMW",
  "postal_code": "SW1A 1AA",
  "rows": 10,
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "active": {
    "num_found": 1250,
    "listings": [
      {
        "year": 2020,
        "make": "BMW",
        "model": "3 Series",
        "trim": "320d M Sport",
        "price": 24995,
        "miles": 32000,
        "fuel_type": "Diesel",
        "dealer": {
          "name": "BMW Park Lane",
          "city": "London"
        }
      }
    ],
    "stats": {
      "price": {
        "mean": 28500
      }
    }
  },
  "recent": {
    "num_found": 890,
    "stats": {
      "price": {
        "mean": 26200
      }
    }
  }
}

View app that uses this endpoint →

POST /api/proxy/scan-uk-lot-pricing

UK Lot Pricing

UK dealer inventory with recent market comparison.

Underlying MarketCheck APIs

UK Active Listings (dealer)UK Recent Listings

Parameters

NameTypeRequiredDescription
dealer_idstringYesUK dealer ID
makestringNoMake filter

Example Request

POST https://apps.marketcheck.com/api/proxy/scan-uk-lot-pricing
Content-Type: application/json

{
  "dealer_id": "uk_dealer_123",
  "_auth_mode": "api_key",
  "_auth_value": "YOUR_API_KEY"
}

Example Response

{
  "inventory": {
    "num_found": 45,
    "listings": [
      {
        "year": 2021,
        "make": "Volkswagen",
        "model": "Golf",
        "trim": "R-Line",
        "price": 22495,
        "miles": 18000,
        "fuel_type": "Petrol"
      }
    ],
    "stats": {
      "price": {
        "mean": 24800
      },
      "miles": {
        "mean": 22000
      }
    }
  },
  "recent": {
    "num_found": 28,
    "stats": {
      "price": {
        "mean": 21500
      }
    }
  }
}

View app that uses this endpoint →