Apibara.tech · Schema
VehicleDetailsResponse
Automotivevehicle-auction-dataCopartIAAIvin-historyMarketplaceREST APIVehicle AuctionsSalvage AuctionsVIN DataUsed-Car Marketplace DataData InfrastructureData as a ServiceRESTJSON:APIMCPAgent-Native
Properties
| Name | Type | Description |
|---|---|---|
| data | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/apibara-tech/json-schema/apibara-tech-vehicle-details-response-schema.json",
"title": "VehicleDetailsResponse",
"x-generated": "2026-10-29",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/apibara-tech-url-tools-api-openapi.yml#/components/schemas/VehicleDetailsResponse",
"type": "object",
"properties": {
"data": {
"$ref": "#/$defs/Vehicle"
}
},
"$defs": {
"AuctionInfo": {
"type": "object",
"properties": {
"state": {
"type": "string"
},
"auction_at": {
"type": "string",
"format": "date-time"
},
"lot_status": {
"type": "string"
},
"lot_sub_status": {
"type": "string"
},
"last_sold_day": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Last known sale-outcome day. Placeholder dates before year 2000 are normalized to null."
},
"last_sold_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Exact source-backed sale/outcome observation timestamp when available. Null when only a day-level sale date is known."
},
"last_sold_status": {
"type": [
"string",
"null"
]
},
"outcome_status": {
"type": [
"string",
"null"
],
"enum": [
"Sold",
"Sold on Approval",
"Not Sold",
"Removed",
null
],
"description": "Explicit normalized outcome only; elapsed time alone is not treated as a sale."
},
"auction_ended_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Best known completed-auction/outcome timestamp. Prefers source-backed sale/outcome evidence; otherwise may use a past scheduled auction timestamp. Never uses a future schedule as an ended timestamp."
},
"outcome_observed_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Timestamp when the current outcome was observed/persisted. Prefers source-backed sale evidence; falls back to the persisted vehicle update timestamp when exact source timing is unavailable."
},
"lot_removed": {
"type": "boolean",
"description": "Source/parser evidence that the lot was removed from active inventory."
},
"sold_buy_now": {
"type": "boolean"
},
"sold_timed": {
"type": "boolean"
}
},
"additionalProperties": true
},
"EstimatedCost": {
"type": "object",
"description": "Apibara robust historical price estimate. The base comparable set uses distinct final sold lots matching exact make + model + model year + primary damage; Copart \"Sold on Approval\" is excluded because it is a non-final high bid. Base from/to are Q1-Q3 and at least 3 exact final-sale comparables are required. When enough final sales exist for the target engine and mileage band (or engine alone), a market-value multiplier refines the range for high/low trims. The most recent retained non-final high bid from the same lot may be exposed as previous_high_bid_usd for context only; it never changes from, median or to and is never treated as a confirmed sale.",
"properties": {
"from": {
"type": "integer",
"minimum": 101,
"description": "Lower bound in USD. Starts from the exact-damage Q1 and may be engine/mileage-refined when sufficient final-sale data exists."
},
"to": {
"type": "integer",
"minimum": 101,
"description": "Upper bound in USD. Starts from the exact-damage Q3 and may be engine/mileage-refined when sufficient final-sale data exists. Previous lot bids never extend this bound."
},
"median": {
"type": "integer",
"minimum": 101,
"description": "Central estimate in USD. Starts from the exact-damage median and may be engine/mileage-refined when sufficient final-sale data exists. Previous lot bids never change this value."
},
"text": {
"type": "string",
"description": "Human-readable Q1-Q3 USD range."
},
"sample_count": {
"type": "integer",
"minimum": 3,
"description": "Number of distinct exact make + model + year + primary-damage final sold comparable lots. Copart Sold on Approval is excluded. Estimate is null when fewer than 3 exist."
},
"refinement_method": {
"type": [
"string",
"null"
],
"enum": [
"engine_mileage",
"engine",
null
],
"description": "Optional high/low-trim refinement. engine_mileage is preferred when at least 5 final-sale comparables exist in the target engine+mileage band; engine is the fallback when at least 5 engine-matched final sales exist."
},
"refinement_sample_count": {
"type": [
"integer",
"null"
],
"minimum": 5,
"description": "Number of final-sale comparables behind the engine or engine+mileage refinement; null when no refinement was applied."
},
"engine_size_l": {
"type": [
"number",
"null"
],
"description": "Normalized engine displacement used by the refinement, in liters."
},
"mileage_bucket": {
"type": [
"string",
"null"
],
"description": "Mileage band considered by the refinement, for example 0-30k or 30-75k. Engine-only fallback may still report the target band."
},
"market_multiplier": {
"type": [
"number",
"null"
],
"description": "Median market-value ratio of the selected engine/mileage cohort to the same make+model+year market, applied to the damage-specific base range."
},
"previous_high_bid_usd": {
"type": [
"integer",
"null"
],
"minimum": 101,
"description": "Most recent retained high bid from the previous non-final auction cycle for the same platform+lot (for example Not Sold or Sold on Approval). This is context only: it does not change from, median or to and is not a confirmed sale price."
}
},
"required": [
"from",
"to",
"median",
"text",
"sample_count"
],
"additionalProperties": false
},
"IncludedVehicleHistoryItem": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"copart",
"iaai"
]
},
"lot_number": {
"type": [
"string",
"integer",
"null"
]
},
"date": {
"type": [
"string",
"null"
],
"format": "date"
},
"price": {
"type": [
"number",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"IncludedVinLot": {
"type": "object",
"description": "Summary-form auction lot for the same VIN. Field availability depends on source and lot state.",
"properties": {
"platform": {
"type": "string"
},
"lot_number": {
"type": [
"string",
"integer",
"null"
]
},
"vin": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
},
"make": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"auction": {
"$ref": "#/$defs/AuctionInfo"
},
"pricing": {
"$ref": "#/$defs/PricingInfo"
}
},
"additionalProperties": true
},
"MediaInfo": {
"type": "object",
"properties": {
"thumbs_count": {
"type": "integer",
"minimum": 0,
"description": "Total source image count represented by the vehicle media set."
},
"has_360": {
"type": "boolean",
"description": "True when IAAI Link360 or Copart copartMedia.views_360 source data is available."
},
"photos": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"images_count": {
"type": "integer",
"minimum": 0,
"description": "Total image count."
},
"items_count": {
"type": "integer",
"minimum": 0,
"description": "Number of media items returned in this response. Summary view may return fewer items than images_count."
},
"has_video": {
"type": "boolean"
},
"items": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"PricingInfo": {
"type": "object",
"properties": {
"current_bid_usd": {
"type": [
"number",
"null"
],
"description": "Current observed bid. Zero/unavailable source values are normalized to null."
},
"buy_now_usd": {
"type": [
"number",
"null"
],
"description": "Buy Now amount; unavailable/zero source placeholders are null."
},
"sale_price_usd": {
"type": [
"number",
"null"
],
"description": "Canonical persisted final/approval price when positive; unavailable/zero source placeholders are null."
},
"current_bid_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Source-backed observation timestamp for current_bid_usd when a matching bid event for the current auction cycle was captured. Null when no matching source timestamp exists; never inferred from generic vehicle updated_at."
},
"current_bid2_usd": {
"type": [
"number",
"null"
],
"description": "Legacy secondary source bid field. Zero/unavailable values are normalized to null."
},
"last_sold_price_usd": {
"type": [
"number",
"null"
],
"description": "Persisted last known positive sale price; unavailable/zero source placeholders are null."
},
"estimated_retail_value_usd": {
"type": [
"number",
"null"
],
"description": "Copart Estimated Retail Value (ERV) when the Copart source provides a positive value. Null for IAAI and for Copart records where ERV is unavailable or zero."
},
"estimated_cost": {
"oneOf": [
{
"$ref": "#/$defs/EstimatedCost"
},
{
"type": "null"
}
],
"description": "Apibara robust historical final-sale estimate. Exact make + model + model year + primary damage Q1-Q3 is the base and fewer than 3 exact final-sale comparables yields null. Copart Sold on Approval / On Approval is excluded. When sufficient final sales exist, engine + mileage-band (or engine-only) market-value refinement adjusts high/low-trim vehicles. The most recent retained non-final bid for the same lot may be exposed as previous_high_bid_usd strictly as context and never changes the Q1-Q3 range or median. Distinct from Copart estimated_retail_value_usd."
}
},
"additionalProperties": true
},
"Vehicle": {
"type": "object",
"description": "Normalized Copart or IAAI auction vehicle record.",
"properties": {
"platform": {
"type": "string"
},
"lot_number": {
"type": "string"
},
"vin": {
"type": "string"
},
"title": {
"type": "string"
},
"year": {
"type": "integer"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"series": {
"$ref": "#/$defs/VehicleSeries"
},
"generation": {
"$ref": "#/$defs/VehicleGeneration"
},
"type": {
"type": "string"
},
"color": {
"type": "string"
},
"fuel_type": {
"type": "string"
},
"transmission": {
"type": "string"
},
"drive_type": {
"type": "string"
},
"odometer": {
"type": [
"object",
"null"
],
"description": "Source-backed odometer readings in miles and kilometres. Missing readings may be null; unknown mileage is not zero.",
"properties": {
"mi": {
"type": [
"number",
"null"
],
"minimum": 0
},
"km": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": true
},
"damage": {
"type": "string"
},
"auction": {
"$ref": "#/$defs/AuctionInfo"
},
"pricing": {
"$ref": "#/$defs/PricingInfo"
},
"location": {
"$ref": "#/$defs/VehicleLocation"
},
"media": {
"$ref": "#/$defs/MediaInfo"
},
"history": {
"type": "array",
"description": "Present only when include contains history. Retained sale-history entries for known auction lots of the same VIN.",
"items": {
"$ref": "#/$defs/IncludedVehicleHistoryItem"
}
},
"vin_lots": {
"type": "array",
"description": "Present only when include contains vin_lots. Other known auction lot records for the same VIN, returned in summary form.",
"items": {
"$ref": "#/$defs/IncludedVinLot"
}
},
"details": {
"type": [
"object",
"null"
],
"additionalProperties": true,
"description": "Source-aware detail metadata. IAAI includes normalized inventory sections; auction_information.prebidInformation.reserveMet is a raw IAAI prebid signal and is not equivalent to Copart seller_reserve_met. Copart includes source-backed sale_status (including ess values such as Minimum Bid) and seller_reserve_met when the Copart source explicitly supplies the flag, plus sanitized bid/yard/media metadata. Null in summary view."
},
"vehicle_specs": {
"$ref": "#/$defs/VehicleSpecs"
}
},
"additionalProperties": true
},
"VehicleGeneration": {
"type": [
"object",
"null"
],
"description": "Resolved vehicle generation metadata when the source vehicle can be matched unambiguously.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"generation": {
"type": "string"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"year_from": {
"type": "integer"
},
"year_to": {
"type": [
"integer",
"null"
]
},
"label": {
"type": "string"
}
}
},
"VehicleLocation": {
"type": "object",
"properties": {
"display": {
"type": "string"
},
"state": {
"type": [
"string",
"null"
]
},
"facility_id": {
"type": "string"
}
},
"additionalProperties": true
},
"VehicleSeries": {
"type": [
"object",
"null"
],
"description": "Canonical model-family / series resolved from the generation catalog.",
"properties": {
"key": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"VehicleSpecs": {
"type": "object",
"description": "Normalized vehicle specifications. Field availability varies by auction source and lot.",
"properties": {
"body_style": {
"type": [
"string",
"null"
],
"description": "Normalized body style used by the body_style filter. IAAI uses VehicleClass. Copart primarily uses the source-backed Body Style field; when that source field is missing, a conservative fallback is allowed only from explicit vehicle-type labels that are themselves body categories (for example Sedan, SUV, Coupe, Convertible). Generic AUTOMOBILE is not guessed."
}
},
"additionalProperties": true
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/apibara-tech-vehicle-details-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.