Vehicles

Browse the live Korean inventory and fetch full vehicle detail.

Three endpoints power partner discovery: filter values for dropdowns, paginated list, and single-vehicle detail.

GET /v1/vehicles/facets

Returns distinct filter values currently in catalog. Cached 5 minutes.

curl -H "x-api-key: $KEY" https://api.lmnauto.com/v1/vehicles/facets

Response is flat unique-value arrays — no per-value counts (UIs surface plain “Kia”, not “Kia (1,234)”):

{
  "makes": ["Hyundai", "Kia", "Genesis", "Toyota", "Honda"],
  "models": {
    "Toyota": ["Camry", "RAV4", "Corolla"],
    "Hyundai": ["Sonata", "Tucson", "Palisade"]
  },
  "fuels": ["gasoline", "hybrid", "diesel", "electric", "lpg"],
  "transmissions": ["auto", "manual", "cvt", "dct"],
  "sources": ["glovis", "sk", "aj", "lotte", "kcar", "dealer"],
  "as_of": "2026-04-15T21:50:00+09:00"
}

Optional query: source (CSV) to scope facets to a specific source set.

GET /v1/vehicles

Paginated, filterable inventory list. Returns VehicleSummary[].

Filters

Param	Type	Notes
make	string CSV	e.g., Kia,Hyundai.
model	string CSV	Requires make.
year_min / year_max	integer	Inclusive bounds.
mileage_max_km	integer	Inclusive upper bound.
price_min_usd / price_max_usd	integer	On pricing.listing_usd.
source	enum CSV	`dealer	glovis	sk	aj	lotte	kcar`.
fuel, transmission	enum CSV
accident_grade, exterior_grade	enum CSV	`A	B	C	D	F`. Excludes dealer rows (null grade).
options_include	string CSV	AND semantics — vehicle must have all listed options.
auction_date_from / auction_date_to	ISO 8601 date	Excludes dealer rows.
auction_count_min / auction_count_max	integer	Number of times listed. Excludes dealer rows when set.
sort	enum	See sort table below. Default auction_date_asc.
cursor, limit	pagination	Composite cursor; default 50, max 200.

Sort

Value	Meaning
auction_date_asc (default)	Closest auction first (decisions needing attention)
price_asc / price_desc	Budget-driven browsing
year_desc	Newest first
mileage_asc	Lowest mileage first

Null-strict semantics

When you filter on a field that’s null for dealer cars (accident_grade, auction_date_*, auction_count_*), dealer rows are silently excluded. Response includes X-LMN-Filtered-Out: dealer=N header so your UI can tell the dealer “42 dealer cars were hidden”.

Dealer source constraint

source=dealer (or no source filter) requires at least one of make or model — dealer inventory isn’t browsable in bulk. Returns 400 validation_error (details.field: "make") otherwise.

Response

{
  "data": [
    {
      "id": "01HXYZ111",
      "source": "glovis",
      "make": "Toyota",
      "model": "Camry",
      "trim": "LE Hybrid",
      "year": 2023,
      "mileage_km": 18500,
      "fuel": "hybrid",
      "auction_date": "2026-04-18T13:00:00+09:00",
      "order_cutoff_at": "2026-04-17T00:00:00+09:00",
      "thumbnail_url": "https://storage.googleapis.com/...",
      "pricing": { "listing_usd": 14500, "delta_pct": -5.2 },
      "auction_result": "upcoming",
      "auction_count": 2
    }
  ],
  "next_cursor": "eyJpZCI6InZlaF8wMUhYWVoyMjIifQ=="
}

Full Vehicle schema in Schemas.

GET /v1/vehicles/

Returns the full Vehicle Detail — Summary fields plus VIN, photos, body condition diagram, full inspection report, and price breakdown.

curl -H "x-api-key: $KEY" https://api.lmnauto.com/v1/vehicles/01HXYZ...

Error	When
404 vehicle_not_found	Unknown ID, or wrong environment.

Detail response includes pricing.breakdown_usd (auction fee, LMN commission, Korean export, ocean freight, estimated landed) and pricing.history (all prior auction appearances).