Skip to content
Eden Engine

Auction Vehicle Lookup by Lot Number

omnial/get-vehicle-by-lot

Given an auction lot number, returns that vehicle's listing details: make/model/year, VIN, primary damage and loss type, odometer reading, title/sale document status, seller, auction location, current bid and time remaining, estimated value range, and both thumbnail and full-size photo URLs. A lot number that matches no active listing returns an empty result rather than an error.

activeper callv1
Provider
Web & Business Data Network
Category
automotive
Provider price
$0.01365 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "required": [
    "lot"
  ],
  "properties": {
    "lot": {
      "type": "string",
      "description": "Auction lot number (e.g. 1-84218605)."
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "img": {
          "type": "object",
          "properties": {
            "img_1": {
              "type": "string"
            },
            "img_2": {
              "type": "string"
            },
            "img_3": {
              "type": "string"
            },
            "img_4": {
              "type": "string"
            },
            "img_5": {
              "type": "string"
            }
          },
          "description": "Thumbnail photo URLs, keyed img_1..img_N -- 5 keys observed on the one real fixture. Vendor image CDN (images.bid.cars), not this platform's own infrastructure. A car with more or fewer photos than observed is unconfirmed and any key beyond what this allowlist names is dropped, not guaranteed to be missing from the upstream response.",
          "additionalProperties": true
        },
        "lot": {
          "type": "string",
          "description": "Echoes the requested lot number."
        },
        "tag": {
          "type": "string",
          "description": "A slug combining year/make/model/VIN, e.g. '2024-Toyota-Corolla-<VIN>'."
        },
        "vin": {
          "type": "string"
        },
        "name": {
          "type": "string",
          "description": "Short vehicle title, e.g. '2024 Toyota Corolla, LE'."
        },
        "type": {
          "type": "string",
          "description": "Vehicle category, e.g. 'Automobile'."
        },
        "specs": {
          "type": "object",
          "properties": {
            "hybrid": {
              "type": [
                "string",
                "null"
              ],
              "description": "Null on the one non-hybrid call observed."
            },
            "key_info": {
              "type": "string",
              "description": "e.g. 'Present'."
            },
            "fuel_type": {
              "type": "string",
              "description": "Coded value, e.g. '0'; meaning is unconfirmed."
            },
            "drive_type": {
              "type": "number",
              "description": "Coded value; meaning beyond the raw code is unconfirmed."
            },
            "transmission": {
              "type": "number",
              "description": "Coded value; meaning beyond the raw code is unconfirmed."
            },
            "engine_rendered": {
              "type": "string",
              "description": "Human-readable engine summary, e.g. '2.0L, I4, 169HP'."
            }
          },
          "additionalProperties": true
        },
        "seller": {
          "type": "string",
          "description": "The auction seller of record, e.g. an insurance company -- '---' when none is on file, per the one call observed. Business/organization identity, not a private person."
        },
        "status": {
          "type": "number",
          "description": "Internal auction status code (0 observed); meaning beyond that is unconfirmed."
        },
        "location": {
          "type": "string",
          "description": "Auction yard city/state, e.g. 'Milwaukee... (WI)'."
        },
        "odometer": {
          "type": "number"
        },
        "final_bid": {
          "type": [
            "number",
            "null"
          ],
          "description": "The winning bid amount once the auction closes; null while still open (observed)."
        },
        "has_video": {
          "type": "boolean"
        },
        "img_large": {
          "type": "object",
          "properties": {
            "img_1": {
              "type": "string"
            },
            "img_2": {
              "type": "string"
            },
            "img_3": {
              "type": "string"
            },
            "img_4": {
              "type": "string"
            },
            "img_5": {
              "type": "string"
            },
            "img_6": {
              "type": "string"
            },
            "img_7": {
              "type": "string"
            },
            "img_8": {
              "type": "string"
            },
            "img_9": {
              "type": "string"
            },
            "img_10": {
              "type": "string"
            },
            "img_11": {
              "type": "string"
            },
            "img_12": {
              "type": "string"
            },
            "img_13": {
              "type": "string"
            }
          },
          "description": "Full-size photo URLs, keyed img_1..img_N -- 13 keys observed on the one real fixture. Vendor image CDN (pluto.bid.car), not this platform's own infrastructure. A car with more or fewer photos than observed is unconfirmed and any key beyond what this allowlist names is dropped, not guaranteed to be missing from the upstream response.",
          "additionalProperties": true
        },
        "loss_type": {
          "type": "string",
          "description": "'---' when no loss type is on file, observed on the one call made."
        },
        "name_long": {
          "type": "string",
          "description": "Longer vehicle title -- identical to `name` on the one call observed."
        },
        "time_left": {
          "type": "number",
          "description": "Seconds remaining until the auction closes."
        },
        "video_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "Null on the one call observed (no video available); shape when populated is unconfirmed."
        },
        "start_code": {
          "type": "string",
          "description": "Run/drive status, e.g. 'Run / Drive'."
        },
        "seller_long": {
          "type": "string",
          "description": "Longer form of `seller`."
        },
        "sold_before": {
          "type": "number",
          "description": "0 or 1 flag for whether this vehicle has sold before, per the one call observed."
        },
        "has_360_view": {
          "type": "boolean"
        },
        "prebid_price": {
          "type": "string",
          "description": "e.g. '$0' when no pre-bid exists yet."
        },
        "view_360_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "Null on the one call observed (no 360 view available); shape when populated is unconfirmed."
        },
        "buy_now_price": {
          "type": [
            "number",
            "null"
          ],
          "description": "A fixed buy-it-now price, when the seller offers one; null when not offered (observed)."
        },
        "estimated_max": {
          "type": "number",
          "description": "Estimated retail value range, high end, USD."
        },
        "estimated_min": {
          "type": "number",
          "description": "Estimated retail value range, low end, USD."
        },
        "sale_document": {
          "type": "string",
          "description": "Short sale-document code, e.g. 'SC'."
        },
        "search_status": {
          "type": "string",
          "description": "e.g. 'active'."
        },
        "primary_damage": {
          "type": "string"
        },
        "seller_trusted": {
          "type": "number",
          "description": "0 or 1 flag, per the one call observed."
        },
        "title_has_lien": {
          "type": "number",
          "description": "0 or 1 flag, per the one call observed."
        },
        "odometer_substr": {
          "type": "number",
          "description": "Meaning unconfirmed beyond the raw value observed."
        },
        "start_code_color": {
          "type": "string",
          "description": "UI color hint for `start_code`, e.g. 'green'."
        },
        "buy_now_close_time": {
          "type": "number",
          "description": "Unix-ish timestamp/duration for the buy-now window; 0 observed when not offered."
        },
        "odometer_km_substr": {
          "type": "number",
          "description": "Meaning unconfirmed beyond the raw value observed."
        },
        "final_bid_formatted": {
          "type": [
            "string",
            "null"
          ],
          "description": "Formatted form of `final_bid`; null while still open (observed)."
        },
        "sale_document_split": {
          "type": "string",
          "description": "'`sale_document` (`sale_document_state`)' combined."
        },
        "sale_document_state": {
          "type": "string",
          "description": "US state the sale document is issued in."
        },
        "time_left_formatted": {
          "type": "string",
          "description": "e.g. '2 d 15 h 11 min'."
        },
        "prebid_close_time_lang": {
          "type": "object",
          "properties": {
            "en": {
              "type": "string"
            },
            "pl": {
              "type": "string"
            },
            "ru": {
              "type": "string"
            },
            "ua": {
              "type": "string"
            }
          },
          "description": "The pre-bid close time, pre-formatted in four languages.",
          "additionalProperties": true
        },
        "sale_document_external": {
          "type": "string",
          "description": "Human-readable document type/state, e.g. 'CERT OF TITLE-SALVAGE VEHICLE (WI)'."
        },
        "sale_document_external_status": {
          "type": "number",
          "description": "0 or 1 flag, per the one call observed."
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on the one found-lot call observed."
    }
  },
  "description": "The vehicle listing, as returned at routing.responseResultPath ($.output). A lot number matching no active listing shapes to an empty object -- treat `{}` as 'no listing found for this lot', not as a failed call.",
  "additionalProperties": true
}

Pricing

Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.

Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.

ChargeRate
Per call
Flat, regardless of what comes back
$0.01365
Cost basis
Not recorded

This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.

Updated
Sep 23, 2026