{"id":"f8b47b83-7f0e-41b6-b890-f90f52e174a5","slug":"copart-com-api","name":"copart.com API","description":"copart.com API","front_facing_description":"Access data from copart.com.","source_url":"https://copart.com","is_authenticated":false,"canonical_scraper_id":"1e2b7b83-e1a6-4e01-8be6-1e8f6d973242","apis":[{"method":"GET","endpoint_name":"search_lots","description":"Free-text search of Copart's public auction inventory (make, model, year, damage, VIN fragment, keywords such as one might type into the site search box). One result row per lot currently listed for sale; each row carries vehicle facts, title/damage, location, auction date/time and the current high bid. Only lots on sale are indexed, so sold lots do not appear here (use get_lot with a known lot number for those). Pagination is offset-based: `page` (1-based, default 1) and `page_size` (default 20, clamped to 100) tile the stream reported by `total_results`; `has_more` is true while further pages exist. `sort` selects the ordering (default is the site's relevance ordering). Some fields are null for lots the site has not yet fully processed (e.g. auction_date, title_group, odometer_status). Costs two upstream requests per call. An unknown search term returns an empty `lots` array with total_results 0.","input_params":{"page":{"type":"integer","required":false,"description":"1-based page number.","default":1},"sort":{"type":"string","required":false,"description":"Result ordering.","default":"best_match","enum":"LotSort","closed":true},"query":{"type":"string","required":true,"description":"Free-text search term, e.g. a make and model.","domain":{"kind":"open","example":"toyota camry","pattern":"^.+$","generator":{"type":"static","value":"toyota camry"}}},"page_size":{"type":"integer","required":false,"description":"Lots per page; values above 100 are clamped to 100.","default":20}},"return_schema":{"type":"object","fields":{"lots":"array of lot summaries; lot_number (string) is the key for get_lot; high_bid is the current high bid in `currency`; estimated_retail_value and repair_cost are site estimates; auction_date is UTC ISO-8601 or null when not scheduled; sold is false for all lots in search (only open lots are indexed)","page":"1-based page returned","query":"echo of the search term","has_more":"true when a later page exists","page_size":"effective page size after clamping","total_results":"total matching lots reported by the site"},"sample":{"data":{"lots":[{"lane":null,"make":"TOYOTA","sold":false,"trim":"SE","year":2025,"color":"WHITE","drive":"FRONT WHEEL DRIVE","model":"CAMRY","title":"2025 TOYOTA CAMRY SE","engine":"2.5L 4","lot_url":"https://www.copart.com/lot/58907616/clean-title-2025-toyota-camry-se-nj-glassboro-west","currency":"USD","has_keys":"YES","high_bid":3950,"odometer":36130.0,"condition":"RUNS AND DRIVES","cylinders":"4","fuel_type":"ELECTRIC AND GAS HYBRID","sale_name":"WHOLESALE AUCTION","body_style":"SEDAN","lot_number":"58907616","title_code":"CT","vin_masked":"4T1DAACK5SU******","item_number":0,"model_group":"CAMRY","repair_cost":5705.0,"sale_status":"Minimum Bid","seller_name":null,"seller_type":"Bank","title_group":"CLEAN TITLE","title_state":"IN","auction_date":"2026-10-13T16:00:00Z","last_updated":"2026-10-10T08:19:55Z","location_zip":"08028 3273","transmission":"AUTOMATIC","location_city":"GLASSBORO","location_name":"NJ - GLASSBORO WEST","thumbnail_url":"https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0726/e93aa350b46445d5b80b2097f3fb0b6b_thb.jpg","location_state":"NJ","primary_damage":"NORMAL WEAR","condition_grade":2.7,"lot_status_code":"O","odometer_status":"ACTUAL","auction_timezone":"EDT","buy_it_now_price":null,"location_country":"USA","sale_status_code":"MINIMUM_BID","secondary_damage":null,"title_description":"CERTIFICATE OF TITLE","auction_time_local":"12:00:00","seller_reserve_met":false,"estimated_retail_value":23220.0}],"page":1,"query":"toyota camry","has_more":true,"page_size":5,"total_results":11586},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.lots","op":"array_min_len","value":1},{"path":"$.data.lots[*]","op":"field_present","value":"lot_number"},{"path":"$.data.lots[*]","op":"field_present","value":"high_bid"},{"path":"$.data.total_results","op":"type_is","value":"number"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_lot","description":"Full record for one Copart lot by lot number: vehicle information, title and damage, location, sale/auction details, bid information, the inspection condition report (when the site provides one), and the complete photo gallery (thumbnail, full and high-resolution URLs per photo) plus any walk-around video URLs. Works for lots that are still on sale and for lots whose sale has ended: for an open lot `high_bid` is the current high bid and `sold` is false; for a sold lot (`sold` true, `sale_status` \"Sold\", `lot_status_code` \"C\") `high_bid` is the final winning bid recorded in the site's lot data (the site's own page does not display this figure to signed-out visitors). `trim` is not provided by the lot record and is null here; it is available from search_lots. A lot number the site does not know returns a stale_input (input_not_found) error. Costs two upstream requests per call.","input_params":{"lot_number":{"type":"string","required":true,"description":"Copart lot number (digits), as emitted in search_lots lots[*].lot_number.","domain":{"kind":"derived","generator":{"path":"$.data.lots[*].lot_number","type":"derived","from_endpoint":"search_lots"}}}},"return_schema":{"type":"object","fields":{"sold":"true once the lot has been sold","photos":"array ordered by sequence: {sequence, label_code, thumbnail_url, full_url, high_res_url}","high_bid":"current high bid for open lots; final winning bid for sold lots, in `currency`","odometer":"odometer reading (miles for US lots); odometer_status says whether it is ACTUAL","lot_number":"Copart lot number (string)","video_urls":"array of walk-around video URLs (may be empty)","photo_count":"number of photos","repair_cost":"site's estimated repair cost","sale_status":"site sale status label (e.g. Minimum Bid, On Approval, Pure Sale, Sold)","auction_date":"UTC ISO-8601 auction timestamp, null when not scheduled","exterior_color":"exterior color when the site provides it, else null","interior_color":"interior color when the site provides it, else null","estimated_retail_value":"site's estimated retail value, null when not provided","condition_report_damages":"array of inspection findings {item, damage, severity, area, description, image_url}; empty when no condition report exists"},"sample":{"data":{"lane":null,"make":"NISSAN","sold":true,"trim":null,"year":2021,"color":"WHITE","drive":"ALL WHEEL DRIVE","model":"ROGUE","title":"2021 NISSAN ROGUE SV","engine":"2.5L 4","photos":[{"full_url":"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0526/e06f61b971ad436bad4a4e4ec811d048_ful.jpg","sequence":1,"label_code":"DSFA","high_res_url":"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0526/e06f61b971ad436bad4a4e4ec811d048_hrs.jpg","thumbnail_url":"https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0526/e06f61b971ad436bad4a4e4ec811d048_thb.jpg"}],"lot_url":"https://www.copart.com/lot/54990476/salvage-2021-nissan-rogue-sv-ny-buffalo","currency":"USD","has_keys":"YES","high_bid":3000,"odometer":0.0,"condition":"ENHANCED VEHICLES","cylinders":"4","fuel_type":"GAS","sale_name":"NY - BUFFALO","body_style":"SPORT UTILITY VEHICLE","lot_number":"54990476","title_code":"SM","video_urls":[],"vin_masked":"JN8AT3BB9MW******","item_number":2065,"model_group":"ROGUE","photo_count":14,"repair_cost":23727.71,"sale_status":"Sold","seller_name":null,"seller_type":null,"title_group":"SALVAGE TITLE","title_state":"NY","auction_date":"2026-07-20T14:00:00Z","last_updated":"2026-07-28T04:23:19Z","location_zip":"14006 9726","transmission":"AUTOMATIC","location_city":"ANGOLA","location_name":"NY - BUFFALO","thumbnail_url":"https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0526/e06f61b971ad436bad4a4e4ec811d048_thb.jpg","exterior_color":null,"interior_color":null,"location_state":"NY","primary_damage":"FRONT END","condition_grade":0.0,"lot_status_code":"C","odometer_status":"NOT ACTUAL","auction_timezone":"EDT","buy_it_now_price":null,"location_country":"USA","sale_status_code":"Sold","secondary_damage":"SIDE","title_description":"MV-907A SALVAGE CERTIFICATE","auction_time_local":"10:00:00","seller_reserve_met":true,"estimated_retail_value":17446.0,"condition_report_damages":[]},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.lot_number","op":"not_null"},{"path":"$.data.high_bid","op":"type_is","value":"number"},{"path":"$.data.photos","op":"type_is","value":"array"},{"path":"$.data.photos[*]","op":"field_present","value":"full_url"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_lot":{"lot_number":"58907616"},"search_lots":{"sort":"odometer_asc","query":"honda civic","page_size":"3"}},"prefill_inputs":{"search_lots":{"query":"toyota camry"}},"last_verified_at":"2026-10-26T10:01:52.923879+00:00","endpoint_health":[{"endpoint_name":"search_lots","status":"healthy","last_checked_at":"2026-10-26T10:01:52.923879+00:00","last_verified_at":"2026-10-26T10:01:52.923879+00:00","recent_runs":[{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T08:02:52.903289+00:00","status":"ambiguous"},{"at":"2026-10-26T06:03:53.010708+00:00","status":"ambiguous"},{"at":"2026-10-26T04:03:52.874780+00:00","status":"ambiguous"},{"at":"2026-10-26T02:00:25.249559+00:00","status":"ambiguous"},{"at":"2026-10-26T00:04:53.200898+00:00","status":"ambiguous"},{"at":"2026-10-25T22:04:25.273299+00:00","status":"ambiguous"},{"at":"2026-10-25T20:04:25.380815+00:00","status":"ambiguous"},{"at":"2026-10-25T18:01:52.876889+00:00","status":"ambiguous"},{"at":"2026-10-25T16:05:52.952623+00:00","status":"ambiguous"}]},{"endpoint_name":"get_lot","status":"healthy","last_checked_at":"2026-10-26T10:01:52.923879+00:00","last_verified_at":"2026-10-26T10:01:52.923879+00:00","recent_runs":[{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T08:02:52.903289+00:00","status":"blocked"},{"at":"2026-10-26T06:03:53.010708+00:00","status":"blocked"},{"at":"2026-10-26T04:03:52.874780+00:00","status":"blocked"},{"at":"2026-10-26T02:00:25.249559+00:00","status":"blocked"},{"at":"2026-10-26T00:04:53.200898+00:00","status":"blocked"},{"at":"2026-10-25T22:04:25.273299+00:00","status":"blocked"},{"at":"2026-10-25T20:04:25.380815+00:00","status":"blocked"},{"at":"2026-10-25T18:01:52.876889+00:00","status":"blocked"},{"at":"2026-10-25T16:05:52.952623+00:00","status":"blocked"}]}],"sdk_usage_example":null,"sdk_delivery_state":"absent","summary":"Search Copart's public auction inventory and retrieve a lot's vehicle details, photos, condition report and bid information (current high bid for open lots, final bid for sold lots).","updated_at":"2026-10-11T14:55:20.17274+00:00","user_variants":[],"latest_version":1,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Copart does not publish a public developer API or documented data feed for third-party use. Access to their auction data for developers is not offered through any official program as of mid-2025.","q":"Does Copart have an official developer API?"},{"a":"For sold lots the `sold` field is `true`, `sale_status` will reflect a sold label, and `high_bid` contains the final winning bid rather than a live bid. The photo gallery, condition report, vehicle details, and odometer data remain available in the same response shape as open lots.","q":"What does `get_lot` return for a lot that has already sold?"},{"a":"The `query` parameter accepts free-text terms including damage descriptions and location keywords. Structured filters (e.g. a dedicated state, damage-category, or date-range parameter) are not separate inputs on the current endpoint. You can fork the API on Parse and revise it to add structured filter parameters.","q":"Can I filter `search_lots` by location, damage type, or auction date rather than a text query?"},{"a":"The API returns lots from Copart's publicly visible inventory, which includes locations in multiple countries. Odometer units are miles for US lots; behavior for non-US lots may vary. Coverage of specific international Copart domains beyond the primary site is not guaranteed, and dedicated per-country endpoints are not currently included. You can fork the API on Parse and revise it to target a specific regional domain.","q":"Does the API cover Copart lots outside the United States?"},{"a":"The API exposes the current high bid (or final bid for sold lots) via the `high_bid` field in both endpoints, but does not return a bid history log or any bidder-level information. You can fork the API on Parse and revise it to add a bid history endpoint if that data becomes accessible.","q":"Is bid history or individual bidder data available?"}],"keywords":["copart auction API","salvage vehicle auction data","copart lot details API","copart bid price API","copart vehicle search API","copart lot photos API","salvage title auction API","copart VIN search API","copart repair cost data","auto auction inventory API","copart condition report API","copart high bid tracking","total loss vehicle data API","copart auction scraper API"],"use_cases":["Monitor salvage auction prices for a specific make/model by polling `search_lots` and tracking `high_bid` over time.","Build a vehicle history enrichment tool that cross-references VIN fragments from `search_lots` with title and damage fields.","Generate insurance total-loss comparables using `repair_cost` and `estimated_retail` from `get_lot`.","Download the full photo gallery for a lot using the `high_res_url` array from `get_lot` for damage assessment workflows.","Alert users when lots matching saved keywords approach their `auction_date` by querying `search_lots` on a schedule.","Track sold lot final prices by checking the `sold` flag and `high_bid` on `get_lot` after auction close."],"meta_title":"Copart Auction API – Vehicle Lots & Bids","generated_at":"2026-10-11T14:56:19.123389+00:00","lead_paragraph":"The Copart API gives developers access to Copart's public salvage and clean-title auction inventory through 2 endpoints. Use `search_lots` to query active listings by make, model, VIN fragment, or any keyword, and `get_lot` to pull a complete record for one lot including the photo gallery, condition report, odometer reading, repair cost estimate, and current or final bid price.","schema_version":2,"meta_description":"Search Copart's live auction inventory and retrieve full lot details — vehicle specs, damage, photos, condition reports, and bid data — via 2 REST endpoints.","primary_category":"automotive","long_description_md":"## Search Auction Inventory\n\n`search_lots` accepts a free-text `query` parameter — anything from a bare make/model string to a partial VIN or damage keyword — and returns a paginated list of active Copart lots. Each row in the `lots` array includes the `lot_number` that keys into `get_lot`, the current `high_bid` in the lot's `currency`, `estimated_retail` value, title and damage descriptions, auction location, and the scheduled auction date/time. Page size is controlled by `page_size` (capped at 100) and navigation uses the 1-based `page` parameter alongside the `has_more` flag and `total_results` count.\n\n## Full Lot Details\n\n`get_lot` accepts a `lot_number` string and returns the complete record for that auction lot. Vehicle fields include make, model, year, and `odometer` with an `odometer_status` indicator (e.g. ACTUAL). Financial fields include `high_bid` (live for open lots, final for sold lots), `repair_cost`, and `sale_status` labels such as Minimum Bid, On Approval, Pure Sale, or Sold. The `sold` boolean makes it straightforward to distinguish active from closed lots.\n\n## Media and Condition Data\n\nThe `photos` array in `get_lot` is ordered by `sequence` and provides three URL tiers per image — `thumbnail_url`, `full_url`, and `high_res_url` — along with a `label_code` describing the camera angle or condition area. A `photo_count` field gives the total up front. Walk-around `video_urls` are also returned when the site provides them, though the array may be empty. When Copart publishes a condition/inspection report for a lot, it is included in the response as well.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["marketplace","ecommerce"]},"primary_category":"automotive","secondary_categories":["marketplace","ecommerce"],"access_requirements":[]}