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
View JSON Schema on GitHub

JSON Schema

apibara-tech-vehicle-details-response-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.