{ "openapi": "3.0.1", "info": { "title": "Copart Intelligence", "description": "Real-time Copart auction monitor. Filter by make, model, year, damage type, yard, sale date, fuel/drive/body, source (repos/theft recovery). New & updated lots streamed to your webhook or Apify Dataset. Pay-per-lot — $0.05 per new, $0.02 per update.", "version": "0.0", "x-build-id": "b4q8i20fnOAPeD0F3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gallant_illustration~auction-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gallant_illustration-auction-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/gallant_illustration~auction-intelligence/runs": { "post": { "operationId": "runs-sync-gallant_illustration-auction-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/gallant_illustration~auction-intelligence/run-sync": { "post": { "operationId": "run-sync-gallant_illustration-auction-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "makes": { "title": "Vehicle makes", "uniqueItems": true, "type": "array", "description": "Pick from top 40 Copart brands by inventory OR type a custom make name (Lucid, VinFast, classic / specialty — anything not in the dropdown). Case-sensitive — verify exact spelling at the [Copart search page](https://www.copart.com/lotSearchResults). Note: some brands appear in both full + abbreviated forms (CHEV/CHEVROLET, NISS/NISSAN) — for full coverage of that brand, pick both. Pick multiple — any match is included.", "items": { "type": "string", "enumSuggestedValues": [ "ACURA", "ALFA ROMEO", "AUDI", "BMW", "BMW MOTORRAD", "BUICK", "CADILLAC", "CHEV", "CHEVROLET", "CHRYSLER", "DODGE", "FIAT", "FORD", "GENESIS", "GMC", "HONDA", "HYUNDAI", "INFINITI", "JAGUAR", "JEEP", "KIA", "LAND ROVER", "LEXUS", "LINCOLN", "MASERATI", "MAZDA", "MERCEDES BENZ", "MERCEDES-BENZ", "MINI", "MITSUBISHI", "NISS", "NISSAN", "PORSCHE", "RAM", "RIVIAN", "SUBARU", "TESLA", "TOYOTA", "VOLKSWAGEN", "VOLVO" ], "enumTitles": [ "Acura", "Alfa Romeo", "Audi", "BMW", "BMW Motorrad (motorcycles)", "Buick", "Cadillac", "Chev (abbrev. Chevrolet)", "Chevrolet", "Chrysler", "Dodge", "Fiat", "Ford", "Genesis", "GMC", "Honda", "Hyundai", "Infiniti", "Jaguar", "Jeep", "Kia", "Land Rover", "Lexus", "Lincoln", "Maserati", "Mazda", "Mercedes-Benz (no hyphen variant)", "Mercedes-Benz", "Mini", "Mitsubishi", "Niss (abbrev. Nissan)", "Nissan", "Porsche", "RAM", "Rivian", "Subaru", "Tesla", "Toyota", "Volkswagen", "Volvo" ] } }, "models": { "title": "Models", "uniqueItems": true, "type": "array", "description": "Vehicle models, e.g. X5, CAMRY, F-150. Case-sensitive. Best combined with `Makes` to avoid cross-make collisions (e.g. \"1500\" exists for both Chevrolet and RAM). Verify spelling at the [Copart search page](https://www.copart.com/lotSearchResults) — click 'Model' filter.", "items": { "type": "string" } }, "yearMin": { "title": "Year (from)", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Inclusive lower bound on the lot year. Leave empty for no lower bound." }, "yearMax": { "title": "Year (to)", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Inclusive upper bound on the lot year. Leave empty for no upper bound." }, "odometerMax": { "title": "Max odometer", "minimum": 0, "type": "integer", "description": "Upper bound on miles. Leave empty for no upper bound." }, "vehicleTypes": { "title": "Vehicle types", "uniqueItems": true, "type": "array", "description": "Filter by vehicle type. Pick multiple — any match is included.", "items": { "type": "string", "enum": [ "automobile", "atv", "bus", "motorcycle", "dirt_bike", "industrial_equipment", "farm_equipment", "jet_ski", "medium_duty_truck", "trailer", "boat", "construction_equipment", "rv", "snowmobile", "heavy_duty_truck" ], "enumTitles": [ "Automobiles", "ATVs", "Buses", "Motorcycles", "Dirt Bikes", "Industrial Equipment", "Agriculture and Farm equipment", "Jet Skis", "Medium Duty / Box Trucks", "Trailers", "Boats", "Construction equipment", "RVs", "Snowmobiles", "Heavy Duty Trucks" ] } }, "titleGroups": { "title": "Title groups", "uniqueItems": true, "type": "array", "description": "Filter by title group. Pick multiple — any match is included.", "items": { "type": "string", "enum": [ "clean", "salvage", "nonrepairable" ], "enumTitles": [ "Clean Title", "Salvage", "Nonrepairable" ] } }, "damageCodes": { "title": "Primary damage", "uniqueItems": true, "type": "array", "description": "Filter by primary damage. Pick multiple — any match is included. All 25 damage categories Copart offers are supported.", "items": { "type": "string", "enum": [ "all_over", "biohazard", "burn", "burn_engine", "burn_interior", "damage_history", "frame_damage", "front_end", "hail", "mechanical", "minor_dent", "altered_vin", "normal_wear", "partial_repair", "rear_end", "rejected_repair", "replaced_vin", "rollover", "side", "stripped", "top_roof", "undercarriage", "unknown", "vandalism", "water_flood" ], "enumTitles": [ "All Over (multi-area, often total loss)", "Biohazard / Chemical", "Burn", "Burn — Engine", "Burn — Interior", "Damage History (prior repair noted)", "Frame Damage (structural)", "Front End", "Hail", "Mechanical", "Minor Dent / Scratches", "Missing / Altered VIN", "Normal Wear (no notable damage)", "Partial Repair (incomplete fix)", "Rear End", "Rejected Repair (insurance refused fix)", "Replaced VIN", "Rollover", "Side", "Stripped (parts removed, theft recovery)", "Top / Roof", "Undercarriage", "Unknown", "Vandalism", "Water / Flood" ] } }, "location": { "title": "Location (states + yards)", "uniqueItems": true, "type": "array", "description": "Pick US states / Canadian provinces (entire state — auto-expands to every Copart yard there) and/or specific yards. Mix freely — any match is included (union). Example: pick \"Texas — all yards\" plus \"CA - Vallejo\" to monitor all of Texas plus that one California yard. Leave empty to search all locations. Note: the Washington DC yard is grouped under Maryland (MD) — picking \"Maryland — all yards\" includes it.", "items": { "type": "string", "enum": [ "AB", "AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NB", "NC", "ND", "NE", "NH", "NJ", "NM", "NS", "NV", "NY", "OH", "OK", "ON", "OR", "PA", "QC", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY", "ab_calgary", "ab_edmonton", "ak_anchorage", "al_birmingham", "al_cusseta", "al_dothan", "al_mobile", "al_mobile_south", "al_montgomery", "al_tanner", "ar_fayetteville", "ar_little_rock", "az_phoenix", "az_phoenix_north", "az_tucson", "ca_adelanto", "ca_antelope", "ca_bakersfield", "ca_fresno", "ca_hayward", "ca_long_beach", "ca_los_angeles", "ca_martinez", "ca_mentone", "ca_napa", "ca_rancho_cucamonga", "ca_redding", "ca_sacramento", "ca_san_bernardino", "ca_san_diego", "ca_san_jose", "ca_so_sacramento", "ca_sun_valley", "ca_vallejo", "ca_van_nuys", "co_colorado_springs", "co_denver", "co_denver_central", "co_denver_south", "ct_hartford", "ct_hartford_springfield", "de_seaford", "fl_clewiston", "fl_ft_pierce", "fl_jacksonville_north", "fl_miami_central", "fl_miami_north", "fl_miami_south", "fl_ocala", "fl_orlando_north", "fl_orlando_south", "fl_punta_gorda", "fl_tallahassee", "fl_tampa_north", "fl_tampa_south", "fl_west_palm_beach", "ga_atlanta_east", "ga_atlanta_north", "ga_atlanta_south", "ga_atlanta_west", "ga_augusta", "ga_cartersville", "ga_fairburn", "ga_macon", "ga_savannah", "ga_tifton", "hi_honolulu", "ia_cedar_rapids", "ia_davenport", "ia_des_moines", "id_boise", "il_chicago_north", "il_chicago_south", "il_peoria", "il_southern_illinois", "il_wheeling", "in_cicero", "in_dyer", "in_fort_wayne", "in_indianapolis", "ks_kansas_city", "ks_wichita", "ky_earlington", "ky_lexington_east", "ky_lexington_west", "ky_louisville", "ky_walton", "la_baton_rouge", "la_new_orleans", "la_shreveport", "la_vinton", "ma_freetown", "ma_north_boston", "ma_south_boston", "ma_west_warren", "dc_washington_dc", "md_baltimore", "md_baltimore_east", "md_laurel", "me_lyman", "me_windham", "mi_detroit", "mi_flint", "mi_ionia", "mi_kincheloe", "mi_lansing", "mi_wayland", "mn_minneapolis", "mn_minneapolis_north", "mn_st_cloud", "mo_columbia", "mo_sikeston", "mo_springfield", "mo_st_louis", "ms_grenada", "ms_jackson", "mt_billings", "mt_helena", "nb_moncton", "nc_china_grove", "nc_concord", "nc_gastonia", "nc_lagrange", "nc_lumberton", "nc_mebane", "nc_mocksville", "nc_raleigh", "nc_raleigh_north", "nd_bismarck", "ne_lincoln", "nh_candia", "nj_glassboro_east", "nj_glassboro_west", "nj_somerville", "nj_trenton", "nm_albuquerque", "ns_halifax", "nv_57_storage", "nv_las_vegas", "nv_las_vegas_west", "nv_reno", "ny_albany", "ny_buffalo", "ny_long_island", "ny_newburgh", "ny_rochester", "ny_syracuse", "oh_akron", "oh_cleveland_east", "oh_cleveland_west", "oh_columbus", "oh_dayton", "ok_oklahoma_city", "ok_tulsa", "on_cookstown", "on_london", "on_ottawa", "on_toronto", "or_eugene", "or_portland_north", "or_portland_south", "pa_altoona", "pa_chambersburg", "pa_harrisburg", "pa_philadelphia", "pa_philadelphia_east", "pa_pittsburgh_north", "pa_pittsburgh_south", "pa_pittsburgh_west", "pa_scranton", "pa_york_haven", "qc_montreal", "ri_exeter", "sc_columbia", "sc_north_charleston", "sc_spartanburg", "sd_rapid_city", "tn_knoxville", "tn_memphis", "tn_nashville", "crashedtoys_dallas", "tx_abilene", "tx_amarillo", "tx_andrews", "tx_austin", "tx_corpus_christi", "tx_dallas", "tx_dallas_south", "tx_el_paso", "tx_ft_worth", "tx_houston", "tx_houston_east", "tx_longview", "tx_lufkin", "tx_mcallen", "tx_north_austin", "tx_san_antonio", "tx_waco", "ut_ogden", "ut_salt_lake_city", "va_danville", "va_fredericksburg", "va_hampton", "va_richmond", "va_richmond_east", "vt_rutland", "wa_north_seattle", "wa_pasco", "wa_spanaway", "wa_spokane", "wi_appleton", "wi_madison_south", "wi_milwaukee_north", "wi_milwaukee_south", "wv_charleston", "wy_casper" ], "enumTitles": [ "Alberta — all yards", "Alaska — all yards", "Alabama — all yards", "Arkansas — all yards", "Arizona — all yards", "California — all yards", "Colorado — all yards", "Connecticut — all yards", "Delaware — all yards", "Florida — all yards", "Georgia — all yards", "Hawaii — all yards", "Iowa — all yards", "Idaho — all yards", "Illinois — all yards", "Indiana — all yards", "Kansas — all yards", "Kentucky — all yards", "Louisiana — all yards", "Massachusetts — all yards", "Maryland — all yards", "Maine — all yards", "Michigan — all yards", "Minnesota — all yards", "Missouri — all yards", "Mississippi — all yards", "Montana — all yards", "New Brunswick — all yards", "North Carolina — all yards", "North Dakota — all yards", "Nebraska — all yards", "New Hampshire — all yards", "New Jersey — all yards", "New Mexico — all yards", "Nova Scotia — all yards", "Nevada — all yards", "New York — all yards", "Ohio — all yards", "Oklahoma — all yards", "Ontario — all yards", "Oregon — all yards", "Pennsylvania — all yards", "Quebec — all yards", "Rhode Island — all yards", "South Carolina — all yards", "South Dakota — all yards", "Tennessee — all yards", "Texas — all yards", "Utah — all yards", "Virginia — all yards", "Vermont — all yards", "Washington — all yards", "Wisconsin — all yards", "West Virginia — all yards", "Wyoming — all yards", "AB - Calgary", "AB - Edmonton", "AK - Anchorage", "AL - Birmingham", "AL - Cusseta", "AL - Dothan", "AL - Mobile", "AL - Mobile South", "AL - Montgomery", "AL - Tanner", "AR - Fayetteville", "AR - Little Rock", "AZ - Phoenix", "AZ - Phoenix North", "AZ - Tucson", "CA - Adelanto", "CA - Antelope", "CA - Bakersfield", "CA - Fresno", "CA - Hayward", "CA - Long Beach", "CA - Los Angeles", "CA - Martinez", "CA - Mentone", "CA - Napa", "CA - Rancho Cucamonga", "CA - Redding", "CA - Sacramento", "CA - San Bernardino", "CA - San Diego", "CA - San Jose", "CA - So Sacramento", "CA - Sun Valley", "CA - Vallejo", "CA - Van Nuys", "CO - Colorado Springs", "CO - Denver", "CO - Denver Central", "CO - Denver South", "CT - Hartford", "CT - Hartford Springfield", "DE - Seaford", "FL - Clewiston", "FL - Ft. Pierce", "FL - Jacksonville North", "FL - Miami Central", "FL - Miami North", "FL - Miami South", "FL - Ocala", "FL - Orlando North", "FL - Orlando South", "FL - Punta Gorda", "FL - Tallahassee", "FL - Tampa North", "FL - Tampa South", "FL - West Palm Beach", "GA - Atlanta East", "GA - Atlanta North", "GA - Atlanta South", "GA - Atlanta West", "GA - Augusta", "GA - Cartersville", "GA - Fairburn", "GA - Macon", "GA - Savannah", "GA - Tifton", "HI - Honolulu", "IA - Cedar Rapids", "IA - Davenport", "IA - Des Moines", "ID - Boise", "IL - Chicago North", "IL - Chicago South", "IL - Peoria", "IL - Southern Illinois", "IL - Wheeling", "IN - Cicero", "IN - Dyer", "IN - Fort Wayne", "IN - Indianapolis", "KS - Kansas City", "KS - Wichita", "KY - Earlington", "KY - Lexington East", "KY - Lexington West", "KY - Louisville", "KY - Walton", "LA - Baton Rouge", "LA - New Orleans", "LA - Shreveport", "LA - Vinton", "MA - Freetown", "MA - North Boston", "MA - South Boston", "MA - West Warren", "DC - Washington DC", "MD - Baltimore", "MD - Baltimore East", "MD - Laurel", "ME - Lyman", "ME - Windham", "MI - Detroit", "MI - Flint", "MI - Ionia", "MI - Kincheloe", "MI - Lansing", "MI - Wayland", "MN - Minneapolis", "MN - Minneapolis North", "MN - St. Cloud", "MO - Columbia", "MO - Sikeston", "MO - Springfield", "MO - St. Louis", "MS - Grenada", "MS - Jackson", "MT - Billings", "MT - Helena", "NB - Moncton", "NC - China Grove", "NC - Concord", "NC - Gastonia", "NC - Lagrange", "NC - Lumberton", "NC - Mebane", "NC - Mocksville", "NC - Raleigh", "NC - Raleigh North", "ND - Bismarck", "NE - Lincoln", "NH - Candia", "NJ - Glassboro East", "NJ - Glassboro West", "NJ - Somerville", "NJ - Trenton", "NM - Albuquerque", "NS - Halifax", "NV - 57 Storage", "NV - Las Vegas", "NV - Las Vegas West", "NV - Reno", "NY - Albany", "NY - Buffalo", "NY - Long Island", "NY - Newburgh", "NY - Rochester", "NY - Syracuse", "OH - Akron", "OH - Cleveland East", "OH - Cleveland West", "OH - Columbus", "OH - Dayton", "OK - Oklahoma City", "OK - Tulsa", "ON - Cookstown", "ON - London", "ON - Ottawa", "ON - Toronto", "OR - Eugene", "OR - Portland North", "OR - Portland South", "PA - Altoona", "PA - Chambersburg", "PA - Harrisburg", "PA - Philadelphia", "PA - Philadelphia East", "PA - Pittsburgh North", "PA - Pittsburgh South", "PA - Pittsburgh West", "PA - Scranton", "PA - York Haven", "QC - Montreal", "RI - Exeter", "SC - Columbia", "SC - North Charleston", "SC - Spartanburg", "SD - Rapid City", "TN - Knoxville", "TN - Memphis", "TN - Nashville", "CrashedToys Dallas", "TX - Abilene", "TX - Amarillo", "TX - Andrews", "TX - Austin", "TX - Corpus Christi", "TX - Dallas", "TX - Dallas South", "TX - El Paso", "TX - Ft. Worth", "TX - Houston", "TX - Houston East", "TX - Longview", "TX - Lufkin", "TX - McAllen", "TX - North Austin", "TX - San Antonio", "TX - Waco", "UT - Ogden", "UT - Salt Lake City", "VA - Danville", "VA - Fredericksburg", "VA - Hampton", "VA - Richmond", "VA - Richmond East", "VT - Rutland", "WA - North Seattle", "WA - Pasco", "WA - Spanaway", "WA - Spokane", "WI - Appleton", "WI - Madison South", "WI - Milwaukee North", "WI - Milwaukee South", "WV - Charleston", "WY - Casper" ] } }, "sources": { "title": "Source", "uniqueItems": true, "type": "array", "description": "Why the vehicle ended up at Copart. Pick multiple — any match is included. Repos and theft recovery often = clean cars with minimal damage; donations / impounds vary widely.", "items": { "type": "string", "enum": [ "donated", "fleet_lease", "impound", "repossession", "theft_recovery", "water_flood" ], "enumTitles": [ "Donated", "Fleet / Lease", "Impound", "Repossession", "Theft Recovery", "Water / Flood" ] } }, "fuelTypes": { "title": "Fuel type", "uniqueItems": true, "type": "array", "description": "Filter by powertrain. EV / hybrid / diesel each have distinct resale dynamics. Pick multiple — any match is included. Note: Copart stores several hybrid spellings as separate values — to catch every hybrid, pick all three Hybrid options; likewise pick both Flexible options for full E85 coverage.", "items": { "type": "string", "enum": [ "gasoline", "diesel", "electric", "electric_and_gas_hybrid", "hybrid_engine", "hybrid", "flexible_fuel", "flexible", "compressed_natural_gas", "hydrogen_fuel_cell", "unknown" ], "enumTitles": [ "Gasoline", "Diesel", "Electric (EV)", "Hybrid (Electric + Gas)", "Hybrid (engine variant)", "Hybrid (legacy)", "Flexible Fuel (E85)", "Flexible", "Compressed Natural Gas (CNG)", "Hydrogen Fuel Cell", "Unknown" ] } }, "driveTrains": { "title": "Drive train", "uniqueItems": true, "type": "array", "description": "Drive train. Each option covers Copart's different spellings for that drive type (e.g. FWD matches every front-wheel-drive spelling). Pick multiple — any match is included.", "items": { "type": "string", "enum": [ "4x2", "awd", "fwd", "rwd", "4x4_front", "4x4_rear", "unknown" ], "enumTitles": [ "Two-wheel drive (4×2 truck)", "All-wheel drive (AWD)", "Front-wheel drive (FWD)", "Rear-wheel drive (RWD)", "4×4 (FWD-based)", "4×4 (RWD-based)", "Unknown" ] } }, "bodyStyles": { "title": "Body style", "uniqueItems": true, "type": "array", "description": "Body style. Each option covers Copart's many spelling variants for that style. Pick multiple — any match is included.", "items": { "type": "string", "enum": [ "sedan", "suv", "pickup", "hatchback", "coupe", "convertible", "wagon", "cargo_van", "passenger_van", "minivan", "cab_chassis", "cutaway" ], "enumTitles": [ "Sedan", "SUV", "Pickup truck", "Hatchback", "Coupe", "Convertible", "Wagon", "Cargo Van", "Passenger Van", "Minivan", "Cab & Chassis", "Cutaway" ] } }, "runsAndDrivesOnly": { "title": "Runs and Drives only", "type": "boolean", "description": "If true, only lots marked 'Run and Drive' are included.", "default": false }, "engines": { "title": "Engine", "uniqueItems": true, "type": "array", "description": "Filter by engine description. Free-text; multi-word OK (e.g. `2.0L 4`, `3.0L 6`, `4.4L 8`, `5.0L 12` — one space before the cylinder count). ⚠️ Case- and space-sensitive — copy the string verbatim from Copart's Engine facet (a spelling/spacing mismatch silently matches nothing). Copart has thousands of distinct engine descriptions. Pick multiple — any match is included.", "items": { "type": "string" } }, "transmissions": { "title": "Transmission", "uniqueItems": true, "type": "array", "description": "Filter by transmission type — Automatic or Manual (Automatic dominates most inventory). CVT coming in a future release. Pick multiple — any match is included.", "items": { "type": "string", "enum": [ "AUTOMATIC", "MANUAL" ], "enumTitles": [ "Automatic", "Manual" ] } }, "cylinders": { "title": "Cylinders", "uniqueItems": true, "type": "array", "description": "Filter by cylinder count. 4 and 6 are the most common; 8 is moderate; 3, 10 and 12 are rare; 0 = electric vehicles. Pick multiple — any match is included.", "items": { "type": "string", "enum": [ "0", "3", "4", "6", "8", "10", "12" ], "enumTitles": [ "0 (EV — no cylinders)", "3", "4", "6", "8", "10", "12" ] } }, "colors": { "title": "Exterior color", "uniqueItems": true, "type": "array", "description": "Filter by exterior color (e.g. `GRAY`, `BLACK`, `WHITE`, `SILVER`, `MAROON`). ⚠️ Case-sensitive UPPERCASE — must match Copart's spelling. Bonus capability — Copart's own website doesn't offer a color filter, but this Actor can filter by it. Pick multiple — any match is included.", "items": { "type": "string" } }, "saleDatePreset": { "title": "Sale date — quick window", "enum": [ "today", "tomorrow", "next_7_days", "next_30_days" ], "type": "string", "description": "Quick filter for upcoming auctions. Server time (UTC). If both this and the custom dates below are set — preset wins. Leave empty to include all dates." }, "saleDateFrom": { "title": "Sale date — custom from", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Custom lower bound (inclusive). Format `YYYY-MM-DD`. Interpreted as UTC start-of-day. Ignored if `Sale date — quick window` is set." }, "saleDateTo": { "title": "Sale date — custom to", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Custom upper bound (inclusive). Format `YYYY-MM-DD`. Interpreted as UTC end-of-day. Ignored if `Sale date — quick window` is set." }, "salePlatforms": { "title": "Sale platforms — include only", "uniqueItems": true, "type": "array", "description": "Limit results to specific Copart sale platforms. Leave empty to include all platforms.", "items": { "type": "string", "enum": [ "CPRTUSA", "PWUSA", "NCS" ], "enumTitles": [ "Copart USA (CPRTUSA)", "Purple Wave (PWUSA)", "National Crime/Salvage (NCS)" ] } }, "excludeSalePlatforms": { "title": "Sale platforms — exclude", "uniqueItems": true, "type": "array", "description": "Exclude lots from specific sale platforms. Typical use: exclude Purple Wave (PWUSA) which carries higher buyer fees. Cannot overlap with `Sale platforms — include only`.", "items": { "type": "string", "enum": [ "CPRTUSA", "PWUSA", "NCS" ], "enumTitles": [ "Exclude Copart USA", "Exclude Purple Wave (higher fees)", "Exclude NCS" ] } }, "excludeOnApproval": { "title": "Exclude On Approval lots", "type": "boolean", "description": "Skip lots that require seller approval after sale (`On Approval` status). These often don't sell at first auction. Equivalent to Copart UI's 'Pure Sale Items' Featured filter." }, "currentBidMin": { "title": "Current bid — min ($)", "minimum": 0, "type": "integer", "description": "Lowest current bid to include (inclusive, USD). ⚠️ Applied after fetching from Copart — Copart's search has no price filter. When set, the Actor fetches up to 3× more pages to leave room for filtering, which can raise per-run cost. You're still only charged for lots within your price range." }, "currentBidMax": { "title": "Current bid — max ($)", "minimum": 0, "type": "integer", "description": "Highest current bid to include (inclusive, USD). Same fetch caveat as 'Current bid — min'. Pre-bid lots (no current bid yet) count as $0 — kept under this max, but dropped if you also set a positive 'Current bid — min'." }, "buyItNowOnly": { "title": "Buy It Now only", "type": "boolean", "description": "Only show lots with a Buy It Now price (a small share of inventory). No extra fetch cost." }, "features": { "title": "Featured items", "uniqueItems": true, "type": "array", "description": "Mirrors Copart's UI 'Featured items' sidebar. Pick multiple — any match is included. Some Featured items live in dedicated fields above (Buy It Now → 'Buy It Now only', Run and Drive → 'Runs and Drives only', Electric/Hybrid → 'Fuel type', Recovered Thefts / Fleet & Lease → 'Source'). 'Pure Sale' here is the same as enabling 'Exclude On Approval lots'.", "items": { "type": "string", "enum": [ "used", "no_license_required", "hot_items", "featured_vehicles", "offsite_sales", "engine_start", "enhanced", "classics", "inspected", "public_and_general_business", "bank_repossessed", "pure_sale" ], "enumTitles": [ "Used Vehicles", "No License Required", "Hot Items", "Featured Vehicles", "Offsite Sales", "Engine Start Program", "Enhanced Vehicles", "Classics (25+ years)", "Inspected", "Public / General Business", "Bank / Repossessed", "Pure Sale (no approval)" ] } }, "newlyAddedWithinDays": { "title": "Newly added within last N days", "minimum": 1, "maximum": 30, "type": "integer", "description": "Filter to lots added to Copart's inventory within the last N days. Distinct from 'Sale date — quick window' — this is when the lot APPEARED in inventory, not when its auction runs. Typical values: 1 (last 24h), 7 (last week), 30 (last month)." }, "classicsYearsOld": { "title": "Classics — years-old threshold", "minimum": 1, "maximum": 100, "type": "integer", "description": "Override the 25-year default Classics threshold (only applies when `Featured items` includes 'Classics'). Useful for younger-classic ranges (e.g. 15 years) or stricter (e.g. 40 years)." }, "vin": { "title": "VIN search", "pattern": "^[A-HJ-NPR-Z0-9]{17}$", "type": "string", "description": "17-character Vehicle Identification Number (A-Z/0-9, excludes I/O/Q). Combines with other filters via AND — e.g. VIN + Makes=[BMW] narrows to BMW lots matching this VIN. ⚠️ Only one of {VIN, Lot numbers, Free-form search} may be set per run." }, "lotNumbers": { "title": "Lot numbers", "maxItems": 1, "uniqueItems": true, "type": "array", "description": "Look up a specific Copart lot by its lot number. Currently supports a single lot per run (multi-lot lookup coming later). ⚠️ Only one of {VIN, Lot numbers, Free-form search} may be set per run.", "items": { "type": "string", "pattern": "^\\d+$" } }, "freeFormQuery": { "title": "Free-form search", "type": "string", "description": "Full-text keyword search across all lot fields (description, make, model, etc.). Example: `low miles BMW`. Multi-token AND. Combines with other filters via AND. ⚠️ Only one of {VIN, Lot numbers, Free-form search} may be set per run." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "If set, each new/updated lot is POSTed to this URL as JSON (HMAC-signed if a secret is provided). Up to 3 attempts per delivery (initial + 2 retries, backoff 1s then 2s); failed deliveries are queued and retried at the start of the next run." }, "webhookSecret": { "title": "Webhook HMAC secret", "type": "string", "description": "Optional. When set, each webhook delivery includes an `X-CopartIntelligence-Signature` header = `sha256=`. Use this to verify deliveries originate from this Actor." }, "maxResultsPerRun": { "title": "Max results per run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on the number of lots processed per Actor run. Protects against runaway charges on broad filters.", "default": 500 }, "includeUpdated": { "title": "Include updated lots (not just new)", "type": "boolean", "description": "When true, lots seen in a previous run whose details have changed are also output (charged as `lot_updated`, $0.02). When false, only brand-new lots are output (charged as `lot_new`, $0.05).", "default": true }, "outputFormat": { "title": "Output format", "enum": [ "compact", "full", "minimal" ], "type": "string", "description": "Verbosity of each Dataset row and webhook payload. `compact` (recommended) gives full buyer detail — odometer, primary/secondary damage, title, color, drivetrain, fuel, engine, cylinders, run condition, keys, yard name, buy-now price, and more — without the heavy per-panel damages array. `full` adds the per-panel `damages[]` array (with photo URLs), `thumbnailUrl`, `seller`, and the lot URL slug `ldu`. `minimal` keeps only the headline fields (lot, make/model/year, current bid, odometer, primary damage, title group, yard name, location state). The `_metadata` block is always present.", "default": "compact" }, "sortBy": { "title": "Sort results by", "enum": [ "auction_date", "odometer", "year", "make", "model", "item_number", "buy_it_now", "current_bid", "sale_light" ], "type": "string", "description": "Sort order, mirroring Copart's UI 'Sort by' dropdown. Leave empty for Copart's default (sale-light priority). Note: 'Location distance' (sort by nearest ZIP) is coming in a future release — it requires geographic coordinate resolution." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }