SalvageAlert Developer API
REST API for real-time IAA and Copart salvage auction inventory across the US, Canada, UK and Germany. Unified Lot schema across all eight sources, plus an…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
REST API for real-time IAA and Copart salvage auction inventory across the US, Canada, UK and Germany. Unified Lot schema across all eight sources, plus an archived-inventory browse endpoint. 50 free credits are granted when you turn API access on.
Field conventions. Timestamp units and boolean representation are NOT uniform across this API, and the exceptions are the ones that bite. Read x-conventions before you write a deserializer — it is four short rules and it is where the millisecond fields are named.
Versioning. Additive changes (new fields, new optional parameters, new endpoints) ship without notice and bump the minor version — treat unknown response fields as forgivable. Removals and meaning changes bump the major version and are announced first. Every version is listed with its date and its changes in x-changelog, newest first; diff that array rather than the whole spec. See x-deprecation-policy for what we promise before anything is removed.
Idempotency. Send an Idempotency-Key header on a POST and a retry carrying the same key (scoped to your API key) returns the stored response and is NOT charged again — safe to replay a request whose response you never received. A duplicate that arrives while the first is still running gets 409 idempotency_in_flight; retry shortly. Keys are remembered for 24 hours. A transient failure (429, 402, 5xx) is not stored, so the same key is free to retry.
Test mode. Mint a test key (prefixed sa_test_, instead of sa_live_) from your API dashboard. It authenticates exactly like a live key but is NEVER charged, and the catalogue endpoints return fixed sample data rather than real inventory — so you can build an integration without burning credits or depending on live lots. Every test response carries the header X-Test-Mode: true and a test_mode: true field; image, zip and CSV endpoints return a stub in test mode. Switch to your sa_live_ key for real data.
Examples. Runnable cURL, Node and Python, a Postman collection and a mirror of this spec: https://github.com/SalvageAlert/SalvageAlert-API-Docs
Endpoints 53
Lots
- POSTSearch lots
/lots/searchSearch lots from one source. Cache hits cost 0 credits. Each source pushes down the filters its site can apply (keyword everywhere; year, damage, title and… - GETFetch a single lot by stock #
/lots/:source/:lot_keyAlways bypasses cache so bids and sale state are live. 1 credit on a hit. On copart_us and copart_ca the source of truth is the Copart Sales Data feed we… - GETList all gallery photo URLs (IAA + Copart)
/lots/:source/:lot_key/imagesEnumerate every photo the source exposes for the lot — not just the listing-page thumbnail. IAA (iaai_ca/us): enumerated from the anchor via the resizer… - GETDownload all photos as a ZIP (IAA + Copart)
/lots/:source/:lot_key/images.zipServer-built ZIP containing every photo the source exposes for the lot — IAA (iaai_ca/us, plus the exterior-360 raw frames) and Copart (copart_ca/us/uk, full… - GETVIN relisting history
/vin/:vin/historyEvery distinct lot we have archived for a full 17-character VIN, across every source — the relisting / flip trail. Copart lots carry full, unmasked VINs… - GETTitle-brand / salvage-history check
/vin/:vin/title-checkCarfax-lite title check: whether a VIN has any salvage-auction record in our IAA/Copart archive, and whether any listing carries an explicitly branded title… - POSTBulk VIN history
/vin/batchLook up relisting history for many VINs in one call (max 50). Charges 1 credit per VIN that RETURNED AT LEAST ONE LOT. A VIN we hold nothing for is free,…
Boats
- GETSearch boats and jet skis
/boatsThe boat.vin catalogue: every boat and personal watercraft listed at Copart and IAA in the US and Canada, upcoming and kept after the sale with the last bid… - GETFetch one boat lot
/boats/:source/:lot_keyPhotos, HIN, damage, title, engine, every sale the lot went through, its bid trail, what similar boats sold for (comps) and similar lots. 1 credit; 404 is free. - GETDecode a HIN and list its auctions
/boats/hin/:hinDecodes a hull identification number (builder code, serial, month and year built, model year, in the current, model-year and straight-year formats) and… - GETBoat filter values
/boats/makesMakes (with how many are upcoming), hull types, damage and title buckets, regions, sources and the year range, narrowed by the same filters as /boats. Free.
Inventory
- GETBrowse archived inventory
/inventoryPage through the public archived-inventory index — the same de-duplicated, continuously-crawled catalogue behind salvagealert.com/lots. Reads pre-archived… - GETOne archived lot by identity
/inventory/:source/:lot_keyA single lot from the catalogue, off the index — the same InventoryLot shape /inventory pages through, for every one of the eight sources. No live source… - GETInventory counts per source
/inventory/sourcesLive active-lot counts per source in the archived-inventory index. Use it to discover how much stock each source has available before paging /inventory. 0… - GETThe auction calendar
/auctionsEvery upcoming IAA USA, IAA Canada and Copart sale the worker has read, one chronological list sorted by start. A Copart sale carries its yard in the spelling…
Reference
- GETVehicle make catalogue
/makes - GETModel list for a make
/models?make_id=230 - GETYard / branch catalogue
/yards?source=copart_usThe shape of yards depends on the source, so switch on source before reading it. copart_ca, copart_us — physical yards: { code, name, region }, where region…
Account
- GETAccount profile + credit balance
/meYour account, live credit balance and current per-minute rate limit. 0 credits. - GETAPI usage statistics
/usagePer-day and per-endpoint counts for the last N days (max 90). - GETList your API keys
/api-keysEvery key on the account, live and revoked, masked to its display prefix. current marks the key this call was made with. Free. - POSTMint a new API key
/api-keysIssues one more key without touching the others — a second service, a staging box, a key per customer. The raw secret is returned ONCE. project_url is where… - DELETERevoke one API key
/api-keys/:idRevokes a single key. The calling key may revoke itself — the response lands and the next call with it is a 401. Free. - POSTRotate keys (account-wide, destructive)
/api-keys/rotatePrivileged and irreversible. Revokes EVERY active key on the account — not just the one that made this call — and mints a single fresh key. The raw secret is… - GETYour match history as JSON
/matchesThe lots your saved searches matched, newest first, drawn only from your own searches — the pull path beside the webhook push: reconcile a receiver that was… - GETOne of your matches
/matches/:idA single matched lot from your own searches, with your annotations on it. Free. A match on another account is a 404. - PATCHFavorite, dismiss, annotate or price a match
/matches/:idWrites your decisions on a matched lot: favorite or un-favorite it, dismiss or restore it, set or clear the ceiling (max_bid_value) that the max-bid alert and… - GETExport your match history as CSV
/matches.csvStreams your saved-search match history as a CSV download, drawn only from your own searches. Free — the data was paid for at poll time; reading it back is a…
Webhooks
- GETList webhooks
/webhooks - POSTCreate webhook
/webhooksThe HMAC secret is returned exactly once on creation and cannot be retrieved afterwards. The URL must be absolute https — plain http is refused with… - GETGet webhook
/webhooks/:id - DELETEDelete webhook
/webhooks/:id - PATCHUpdate webhook
/webhooks/:idPartial update. Sending {"active": true} is how you bring back a subscription that was auto-disabled after 20 consecutive failures — fix the receiver first,… - POSTTest fire
/webhooks/:id/testSynchronous one-shot delivery for testing your receiver. Not persisted to the deliveries log; not retried on failure. It is shaped like a real delivery: event… - GETDelivery log
/webhooks/:id/deliveriesRecent deliveries for a webhook, newest first. Use it to self-debug a failing receiver without contacting support — and to see how close a subscription is to… - POSTRedeliver one past delivery
/webhooks/:id/deliveries/:deliveryId/redeliverQueue a failed, dead or delivered delivery again: same payload, a fresh attempt count, sent on the worker's next drain (within a minute). A pending delivery…
Watches
- GETList watches
/watches - POSTCreate watch
/watchesSaved filter set that triggers lot.matched events (kind watch_match). filters JSON is capped at 4 KB — over it, 400 watch_filters_too_large. To pause a watch,… - DELETEDelete watch
/watches/:id - PATCHPause, resume or relabel a watch
/watches/:idUpdates active and/or label in place. Free. Send only the fields you want changed — an omitted field is left alone, so {"active": false} will not blank the…
VIN watches
- GETList VIN watches
/vin-watchesEvery VIN watch on the account, each with the lots it has found and its event trail (listed, sold, listed again). 0 credits. - POSTCreate a VIN watch
/vin-watchesWatch one vehicle. Passively, every lot ingested on any source is checked against the VIN and a hit sends a lot.matched delivery of kind vin_watch_match; with… - GETRead a VIN watch
/vin-watches/:id - DELETEDelete a VIN watch
/vin-watches/:id - PATCHPause, resume or edit a VIN watch
/vin-watches/:idSend only the fields you want changed: active, label, region, sources. Omitted fields are left alone; an empty body is a 400. The VIN cannot be changed.… - POSTRun a VIN watch now
/vin-watches/:id/runRun the watch's keyword sweep inline on the sources it names and return what it found. Needs a region and sources. Once per 24 h per watch (429 cooldown with…
Vehicle data
- GETDecode a VIN
/vehicles/vin/:vinDecode a 17-character VIN into a structured vehicle spec: year, make, model, trim, body class, engine, drivetrain, transmission, plant and more. Pass ?year=… - GETRecalls + crash-test safety
/vehicles/safety?make=Honda&model=Accord&year=2018Open recall campaigns plus crash-test safety ratings for a year/make/model. Costs 0.2 credits. recalls.count: 0 means no OPEN recalls, and only for a model… - GETFuel economy
/vehicles/fuel-economy?make=Toyota&model=Camry&year=2020EPA MPG, fuel type, CO2 and estimated annual fuel cost for a year/make/model. Costs 0.2 credits. The EPA rates trims, not models. A 2020 Camry is 39 MPG…
Market data
- GETSold comparables
/salesRecorded auction cycles across the archive — the closest thing to sold comparables. Filter by make, model, year range, source and sale-date range; paginated.… - GETAggregate market statistics
/stats/market?make=TOYOTAAggregate price snapshot for a make (and optional model) across the whole archive. Costs 1 credit. What the price actually is. Each distinct lot — one row per…
Fees & taxes
- GETAll-in buyer-fee estimate
/fees/estimate?source=iaai_ca&bid=5000All-in buyer-fee breakdown for a hammer price on any marketplace we cover (IAA CA/US/UK, Copart CA/US/UK/DE). Pure calculation — no scrape. Returns the…
Currency
- GETReference exchange rates
/fxDaily reference exchange rates for converting auction prices across the currencies SalvageAlert lots trade in. Defaults to USD base against USD, EUR, CAD and…
API details
- Base URL
https://salvagealert.com/api/v1- Authentication
- A bearer token in the Authorization header
- Operations
- 53 operations on 43 pathsGET 35POST 10PATCH 4DELETE 4
- Main resources
- Account 10Webhooks 8Lots 7VIN watches 6Boats 4Inventory 4Watches 4Reference 3Vehicle data 3Market data 2
- Response formats
application/jsonapplication/ziptext/csv- Description format
- OpenAPI 3.0.3, API version
1.9.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Salvagealert's published OpenAPI description
How to test the SalvageAlert Developer API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the SalvageAlert Developer API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Search lots” (POST /lots/search), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the SalvageAlert Developer API?
REST API for real-time IAA and Copart salvage auction inventory across the US, Canada, UK and Germany. Unified Lot schema across all eight sources, plus an… It is listed under Logistics & shipping and has 53 endpoints.
Who publishes the SalvageAlert Developer API?
It is listed from SalvageAlert's public API description (an OpenAPI document), not published by SalvageAlert on Swastik Codes. Anyone who controls salvagealert.com can claim the profile by adding a DNS TXT record.
What is the base URL of the SalvageAlert Developer API?
Requests go to https://salvagealert.com/api/v1. Endpoint paths are added to this base URL.
How do I authenticate with the SalvageAlert Developer API?
With A bearer token in the Authorization header.
How many endpoints does the SalvageAlert Developer API have?
53 operations on 43 paths (35 GET, 10 POST, 4 PATCH, 4 DELETE). The largest groups are Account, Webhooks, Lots, VIN watches.
Is forking the SalvageAlert Developer API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.