
IAAI APIScraper & Parser
IAAI API: US and Canadian insurance auto auction lots with Buy Now price, ACV and repair estimates, damage, title type and sale date. Change feed and files.
IAAI API
The parser collects auction lots from IAAI, the insurance auto auctions of the US and Canada, including cars, SUVs, pickups and vans. With the API you can filter lots to match a buyer's requirements and track them through the change feed until they are removed from sale. There is no need to write and maintain your own iaai.com scraper.
The /changes feed returns events for IAAI lots: new lot, new Buy Now price, removal from sale.
The daily export holds the IAAI lots that are for sale on the export date.
Mileage and odometer status, engine and power, damage, reason for sale, title type, car keys and airbags, sale date and branch, eligible buyers, photos and engine video.
A lot has two numbers: inner_id, which you use to request the lot from /offer, and stock_number, the number buyers know it by at IAAI auctions.
Base URL
https://{access_name}.auto-api.com/api/v3/iaaiAuthorization: api_key parameter
Workflow
/filtersget available filter valuesInitial load:
/change_id?date=...get starting ID for changes feed/offersfetch all lots page by page/changes?change_id=...get all changes in the database starting from ID/offera single lot by inner_idGetting started:
1. Before the first load, take the number from /change_id for today's date and keep it. Then go through /offers page by page to the end: on the last page next_page is null.
2. After that, poll /changes from this number and pass next_change_id from each response. New lots, new Buy Now prices and removals of lots from sale come this way. If next_change_id is null, there are no events yet: repeat the same request later.
3. To search by your own criteria, request /offers with filters.
Data format
- Types are kept: a number comes as a number, a list as an array, a missing value as null.
- Timestamps are in UTC, for example "2026-11-12T14:30:00Z".
- The price, ACV and repair estimate are in the lot's currency: USD for US lots, CAD for Canadian lots.
- Every lot has the same set of fields. A missing value is null, for example auction_at until IAAI sets the sale date. photos is the exception: for a lot without photos it is an empty array.
GET/filters
Returns all possible values for filtering
https://{access_name}.auto-api.com/api/v3/iaai/filters?api_key=YOUR_API_KEYResponse:
{
"mark": {
"CHEVROLET": { "model": [..., "TAHOE", "TAHOE HYBRID", "TAHOE K1500", "TRACKER", "TRAILBLAZER", ...] },
"FORD": { "model": [..., "EXPEDITION", "EXPEDITION EL", "EXPEDITION MAX", "EXPLORER", "EXPLORER SPORT", ...] },
"TOYOTA": { "model": [..., "RAV4 HYBRID", "RAV4 PLUG-IN HYBRID", "RAV4 PRIME", "RAV4 SE HYBRID", ...] },
...
},
"transmission_type": ["Automatic", "CVT", "Manual"],
"color": ["Beige", "Black", "Blue", "Brown", ...],
"body_type": [..., "Passenger van", "Pickup", "QUATTRO COUPE", "Roadster", ...],
"engine_type": ["Diesel", "Electric", "Flex fuel", "Gasoline", "Hybrid", "Other"],
"drive_type": ["4WD", "4x2", "AWD", ..., "FWD", ..., "RWD"]
}GET/offers
Lots page by page. Filters narrow down the results.
Parameters:
page(required) - page numbermark, model- make and model as in /filters, case does not mattertransmission_type, color, body_type, engine_type, drive_type- transmission, color, body, fuel and drivetrain, using the values from /filters, case does not matteryear_from, year_to- model year from and tokm_age_from, km_age_to- mileage in km from and toprice_from, price_to- Buy Now price from and to, in the lot's currency. Lots without Buy Now do not match these filters
To pass several values to a filter, repeat the parameter with brackets: mark[]=CHEVROLET&mark[]=FORD
https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&mark=CHEVROLET&model=TAHOE&year_from=2020https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&body_type=Pickup&price_to=15000Response:
{
"result": [
{
"id": 61842,
"inner_id": "43963919~US",
"change_type": "added",
"created_at": "2026-10-25T05:41:52Z",
"data": {
"id": 61842,
"inner_id": "43963919~US",
"stock_number": "43468982",
"url": "https://www.iaai.com/VehicleDetail/43963919~US",
"mark": "CHEVROLET",
"model": "TAHOE",
"complectation": "2WD LT",
"year": 2021,
"first_registration": null,
"km_age": 187368,
"odometer": 116425,
"odometer_unit": "mi",
"odometer_status": "Not actual",
"owners_count": null,
"price": 14000,
"currency": "USD",
"acv": 38323,
"repair_cost": 25348,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "SUV",
"drive_type": "4x2",
"color": "Gray",
"interior_color": null,
"displacement": 5.3,
"displacement_cc": 5300,
"engine": "5.3L V-8 DI, VVT, 355HP",
"cylinders": 8,
"power": 355,
"power_ice_hp": 355,
"power_electro_kw": null,
"seat_count": null,
"section": "Used",
"seller_type": null,
"is_dealer": null,
"salon_id": null,
"seller_category": "Insurance company",
"region": "Georgia",
"city": "Winder",
"address": "1045 Atlanta Hwy SE",
"zip": "30680",
"latitude": 33.97598,
"longitude": -83.6573,
"description": null,
"created_at": "2026-10-25T05:41:52Z",
"offer_created": "2026-10-25T05:33:28Z",
"photos": [
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I1~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I2~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I3~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I4~RW2576~H1932~TH0&width=2576&height=1932",
...
],
"photo_360_url": "https://vis.iaai.com/Home/ThreeSixtyView?keys=SID-43963919~STP-1~INT-1&iframeview=true",
"engine_video_url": "https://mediastorageaccountprod.blob.core.windows.net/media/43963919_VES-100_1",
"vin": "1GNSCNKD0MR******",
"auction_at": "2026-11-12T14:30:00Z",
"auction_type": "Live auction",
"timed_auction_close_at": null,
"branch": "Atlanta East",
"branch_id": "707",
"lane": "D",
"run_number": 153,
"country": "USA",
"primary_damage": "Right rear",
"secondary_damage": "Rear",
"loss_type": "Collision",
"title_group": "Salvage",
"title_state": "Georgia",
"title_brand": null,
"title_notes": null,
"condition": "Run & drive",
"has_keys": true,
"airbags": "Intact",
"catalytic_converter": true,
"is_public": true,
"who_can_buy": ["Dealers", "Dismantlers", "Exporters", "Other licensed businesses", "Non-auto licensed businesses", "Public", "Rebuilders", "Scrappers"],
"vehicle_type": "SUV",
"country_of_origin": "USA",
"restraint_system": ["Driver front airbag", "Driver side airbag", "Curtain airbags", "Passenger front airbag", "Passenger side airbag", "Front center airbag"],
"declarations": null,
"original": { // original values from iaai.com
"mark": "CHEVROLET",
"model": "TAHOE",
"complectation": "2WD LT",
"engine_type": "GASOLINE",
"transmission_type": "AUTOMATIC",
"body_type": "UTILITY",
"drive_type": "4X2 DRIVE",
"color": "GRAY",
"interior_color": null,
"primary_damage": "Right Rear",
"secondary_damage": "Rear",
"loss_type": "Collision",
"title_group": "Salvage",
"condition": "Run & Drive",
"region": "GA"
},
"catalog_ids": {
"mark": null,
"model": null,
"complectation": null
},
"options": {
"Equipment": ["Console display"]
}
}
}
// ... then the other lots, up to 20 per page
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Data fields:
Lot
id - internal database ID
inner_id - Lot ID from the IAAI link with the market after the tilde: "43963919~US", or like "Imp_3139055~CA" for Canadian lots. This is the ID /offer accepts.
stock_number - Stock#, the lot number IAAI shows on its site and at the auction.
url - Link to the lot.
price, currency - Buy Now price and currency, USD or CAD. If the lot has no Buy Now price, price is null.
acv - ACV, the estimated value of the car before the damage.
repair_cost - Estimated cost of repair.
section - Always "Used".
description - Seller's description. IAAI lots have none, so it is always null.
created_at - Time the lot reached our database.
offer_created - Listing time as IAAI states it. IAAI updates it, for example when a lot is relisted or the sale is rescheduled, so it can be later than created_at.
Car
mark, model - Make and model as IAAI writes them: "CHEVROLET", "TAHOE".
complectation - Trim, for example "2WD LT".
year - Model year.
first_registration - First registration. IAAI does not publish it, so it is always null.
vin - VIN as IAAI shows it: the first 11 characters, with the rest hidden by asterisks.
km_age - Mileage in km. If IAAI gives 0 or 1 instead of the mileage (the odometer cannot be read, does not work or the mileage is exempt), null.
odometer, odometer_unit - Odometer reading as on IAAI and its unit: "mi" (miles) or "km".
odometer_status - Odometer status, for example "Actual", "Not actual", "Exceeds mechanical limits" or "Exempt" (older cars are exempt from mileage reporting).
owners_count - Number of owners. IAAI does not publish it, so it is always null.
vehicle_type - Vehicle type in IAAI's classification, for example "Automobile", "Light truck" or "Classic car". The body type comes in body_type.
country_of_origin - Country of assembly.
Specifications
engine_type - Fuel: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" or "Other".
transmission_type - "Automatic", "Manual" or "CVT".
body_type - Body type, for example "SUV" or "Pickup". The body style as IAAI writes it is in original.body_type.
drive_type - Drivetrain: "FWD", "RWD", "AWD" or "4WD". "4x2" means IAAI did not say which axle is driven.
color, interior_color - Body color and interior color.
displacement, displacement_cc - Engine displacement in liters as IAAI gives it, and the same in cc (5.3 l is 5300).
engine - Engine as IAAI describes it, for example "5.3L V-8 DI, VVT, 355HP".
cylinders - Number of cylinders.
power - Power in hp. null for hybrids and electric cars: IAAI does not publish the total system power.
power_ice_hp - Combustion engine power in hp. Filled in for hybrids even when power is null.
power_electro_kw, seat_count - Electric motor power and number of seats. IAAI does not publish them, so they are always null.
Damage and title
primary_damage, secondary_damage - Primary and secondary damage, for example "Front end", "Left side", "Flood" or "Hail".
loss_type - Why the car went to auction: "Collision", "Theft", "Flood", "Fire" or "Other".
condition - Start status: "Run & drive", "Starts", "Stationary" or "Can't test".
has_keys - Whether car keys are present (true/false).
airbags - Airbag condition, for example "Intact", "Deployed" or "Missing".
restraint_system - Airbags and seat belts the car has.
catalytic_converter - Catalytic converter in place (true) or removed (false).
title_group - Title type: "Clear", "Salvage", "Non-repairable" and others. For Canadian lots it comes as IAAI writes it, for example "ON-NOT BRANDED-ONTARIO". null until the title has reached IAAI.
title_state - State or province that issued the title.
title_brand, title_notes - Title brand and notes as IAAI writes them, for example "PREVIOUS SALVAGE".
declarations - Seller declarations on Canadian lots, text as IAAI writes it, for example "TKU" (true kilometres unknown) or a reference to the CARFAX report.
Sale, seller and location
auction_at - Start of the live auction. null until IAAI sets the date. Setting or moving the sale date does not create an event in /changes. /offer and /offers return the latest scheduled auction date and time.
auction_type - "Live auction" or "Timed auction".
timed_auction_close_at - End of the timed auction.
branch, branch_id - IAAI branch where the lot is sold, and the branch number.
lane, run_number - Auction lane and the lot's run number in it. IAAI assigns them shortly before the sale, until then null. Like the sale date, they do not arrive as separate events in /changes.
is_public - true if the lot is open to public buyers (the Public mark). Who else can buy the lot is listed in who_can_buy.
who_can_buy - Who can buy the lot: "Dealers", "Dismantlers", "Exporters", "Public" and others. IAAI fills in the list closer to the sale, until then null.
seller_category - Where the car came to the auction from: "Insurance company", "Remarketing", "Lease and rental", "Repossession" and others.
seller_type, is_dealer, salon_id - Seller. IAAI does not show it, so these fields are always null.
country - "USA" or "Canada".
region, city - State or province and city where the car is located.
address, zip - Address and ZIP or postal code of the same place.
latitude, longitude - Coordinates of the same place. null for Canadian lots.
Photos, videos and reference data
photos - Full-size photo links. An empty array for a lot without photos.
photo_360_url - Link to the 360 view on the IAAI site.
engine_video_url - Link to the engine running video.
options - Equipment as IAAI lists it, in one group "Equipment".
original - Original values of the main fields from iaai.com, untranslated.
catalog_ids - Catalog codes. IAAI does not publish them, so the values are always null.
GET/change_id
Get first change ID by date (for use in /changes)
Parameters:
date(required) - date in yyyy-mm-dd format
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10Response:
{
"change_id": 208400
}Use the returned value as the change_id parameter in /changes
GET/changes
Changes feed (added/changed/removed)
Parameters:
change_id(required) - starting from which change ID
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412Response:
{
"result": [
{
"id": 208412,
"inner_id": "46237543~US",
"change_type": "changed",
"created_at": "2026-11-10T03:12:40Z",
"data": { // new Buy Now price in the lot's currency (null if Buy Now was removed)
"new_price": 28225
}
},
{
"id": 208413,
"inner_id": "47020463~US",
"change_type": "added",
"created_at": "2026-11-10T03:12:41Z",
"data": { ... } // the full lot body, as in /offers
},
{
"id": 208414,
"inner_id": "46769371~US",
"change_type": "removed",
"created_at": "2026-11-10T03:12:43Z",
"data": {} // lot removed from sale
}
// ... then the other events, up to 20 per page
],
"meta": {
"cur_change_id": 208412,
"next_change_id": 208432,
"limit": 20
}
}GET/offer
A single lot by inner_id.
Parameters:
inner_id(required)
https://{access_name}.auto-api.com/api/v3/iaai/offer?api_key=YOUR_API_KEY&inner_id=43963919~USThe response holds only the data object, without a result wrapper.
Errors
On an error, the response has an error field with a description: { "error": "parameter page is required" }
401- the api_key was not accepted400- a required parameter is missing or a value has the wrong format404- no lot with this inner_id (/offer)429- the request limit is used up
Retention
Files stay available for at least 3 days
Availability
Fresh files every morning
CSV Format
CSV columns are separated by the pipe character (|)
URL structure:
Parameters:
access_name- your personal subdomaindate- export date in yyyy-mm-dd format, e.g. 2026-11-10file_name- file name with extension
Available files:
- CSV - all_active.csv, new_daily.csv, removed_daily.csv
- JSON - all_active.json, new_daily.json, removed_daily.json
- Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx
cURL request example
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvWget command example
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'IAAI (iaai.com) is the site of Insurance Auto Auctions (IAA). Since 2023 the company has been part of RB Global. Cars go to auction in the US and Canada from insurance companies after a collision, flood, fire or theft, as well as from banks, dealers, leasing and rental companies.
A lot is sold at a live auction on a set day or in a timed auction, and some lots can be bought before the auction at a Buy Now price. Certain lots are sold only to licensed buyers, such as dealers, dismantlers and exporters, while lots with the Public mark are also open to public buyers. IAAI does not make bids or sale prices public.
An importer can see in the lot whether exporters are allowed to buy it. The model year, displacement and engine power let you estimate import duties, and the first 11 characters of the VIN let you check the model and the plant.
New lots, new Buy Now prices and removals from sale arrive through /changes. A removal from sale does not always mean the lot was sold.
Expand your automotive data coverage across global markets with our platform APIs: