autoAstat API
Pricing
API access is available only after payment is received.
Package STANDARD
Limitations: 100 requests per hour
Price: $199 per month / $1990 per year
Package INDIVIDUAL
Limitations: individual for each customer
Price: individual for each customer
HOW TO GET ACCESS
- Create a new account to use only with autoAstat API. Current accounts with "Personal" and "Pro" plans cannot be used for API.
- Subscribe to API plan at the payment page: https://autoastat.com/en/backoffice/subscribe-api
After payment is done you will automatically receive a unique API token to your email (if you didn't get an email, check the Spam folder) to access the autoAstat database.
Frequently Asked Questions
- Сan we get free demo-access? No, we do not provide free demo access. API access available only after payment received.
- What are the limitations of the API? "Standard" package is limited to 100 requests per hour. In "Individual" package maximum number of requests is to be defined individually.
- When will API be accessible? API will be accessible 24 hours per day, 7 days per week.
User manual
API provides RESTful interface with the responses in JSON format and allows access to the autoAstat resources.
Authentification
API uses the unique token-based (key-based) authentification. You need to include your token in the header of each request. Token header has the name X-API-AUTH-TOKEN. Each API user should receive an API key and can use only one key for one account.
To get the API key generated for you, please email to [email protected]. API access is available only after payment is received.
Requests
All requests to the API should include the following headings:
| name | value |
|---|---|
| Host | autoastat.com |
| Content-Type | "application/json" |
| X-API-AUTH-TOKEN | "Your token" |
Possible values by fields
odometer.unit_of_measure - [mi, km]
odometer.status - [actual, not_actual, exempt, exceeds_limit, broken, burnt, inoperable_digital_dash, missing]
status - [unknown, sold, notsold, pending, removed]
date - trading date
loss_type - type of damage
Limitations
API access is limited with the number of requests by unit of time. "Standard" package allows 100 requests per hour. The same limit for the "Individual" package is defined individually.
When you exceed the allowed limit, you will get the response wtih the HTTP code “429 Too many requests”
API Status
Rarely you can receive the response with the HTTP code “503 Service unavailable”. It is recommended to retry the request in 30 seconds.
Sales history by VIN
GET https://autoastat.com/api/history/{vin}
Sample request
https://autoastat.com/api/history/1FMZU73K83ZB53903
Sample answer
[
{
"win_amount": 1425,
"currency": "USD",
"date": "2021-02-12T07:40:50+00:00",
"sold": false,
"auction_lot_number": 29589213,
"auction": "iaai",
"odometer": {
"value": 149163,
"unit_of_measure": "mi",
"status": "not_actual"
},
"status": "notsold",
"primary_damage": "Left Front",
"secondary_damage": "Left Side",
"seller": {
"name": "CA Auto Sales",
"insurance": false
},
"images": {
"thumbs": [
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/1-7145a6-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/2-847b85-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/3-801361-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/4-466418-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/5-2012f2-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/6-75a1ea-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/7-412ba3-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/8-c7dae5-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/9-6f6715-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/10-7394b9-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/11-9b5d99-lot_thumb.jpg"
],
"previews": [
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/1-7145a6-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/2-847b85-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/3-801361-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/4-466418-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/5-2012f2-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/6-75a1ea-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/7-412ba3-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/8-c7dae5-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/9-6f6715-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/10-7394b9-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/11-9b5d99-lot_preview.jpg"
]
},
"loss_type": "Collision"
},
{
"win_amount": 1625,
"currency": "USD",
"date": "2021-02-19T07:40:50+00:00",
"sold": false,
"auction_lot_number": 29589213,
"auction": "iaai",
"odometer": {
"value": 149163,
"unit_of_measure": "mi",
"status": "not_actual"
},
"status": "notsold",
"primary_damage": "Left Front",
"secondary_damage": "Left Side",
"seller": {
"name": "CA Auto Sales",
"insurance": false
},
"images": {
"thumbs": [
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/1-7145a6-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/2-847b85-lot_thumb.jpg", "https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/3-801361-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/4-466418-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/5-2012f2-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/6-75a1ea-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/7-412ba3-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/8-c7dae5-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/9-6f6715-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/10-7394b9-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/11-9b5d99-lot_thumb.jpg"
],
"previews": [
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/1-7145a6-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/2-847b85-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/3-801361-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/4-466418-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/5-2012f2-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/6-75a1ea-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/7-412ba3-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/8-c7dae5-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/9-6f6715-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/10-7394b9-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/11-9b5d99-lot_preview.jpg"
]
},
"loss_type": "Collision"
},
{
"win_amount": 1750,
"currency": "USD",
"date": "2021-02-26T07:40:50+00:00",
"sold": true,
"auction_lot_number": 29589213,
"auction": "iaai",
"odometer": {
"value": 149163,
"unit_of_measure": "mi",
"status": "not_actual"
},
"status": "sold",
"primary_damage": "Left Front",
"secondary_damage": "Left Side",
"seller": {
"name": "CA Auto Sales",
"insurance": false
},
"images": {
"thumbs": [
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/1-7145a6-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/2-847b85-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/3-801361-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/4-466418-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/5-2012f2-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/6-75a1ea-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/7-412ba3-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/8-c7dae5-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/9-6f6715-lot_thumb.jpg", "https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/10-7394b9-lot_thumb.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/11-9b5d99-lot_thumb.jpg"
],
"previews": [
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/1-7145a6-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/2-847b85-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/3-801361-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/4-466418-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/5-2012f2-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/6-75a1ea-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/7-412ba3-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/8-c7dae5-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/9-6f6715-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/10-7394b9-lot_preview.jpg",
"https://s.autoastat.com/images/iaai/2021/2/12/1HGCM56127A182028/11-9b5d99-lot_preview.jpg"
]
},
"loss_type": "Collision"
}
]
