The car object
It represents the main piece of data you can retrieve using Tesla Hunt API.
Generic attributes
These attributes will be present to any car retrieved.
url
type: string
The teslahunt.io (opens in a new tab) URL to visualize the car information on the web.
e.g., https://teslahunt.io/5YJ3E7EB1LF764754
photos
type: string[]
A collection of photos URLs that represent the car.
The photos can be real or 3D renders in case real photos are not available.
e.g., ['https://cdn.teslahunt.io/…', 'https://cdn.teslahunt.io/…', '…']
vin
type: string
The vehicle identification number of the car.
e.g., 5YJ3E7EB1LF764754
title
type: string
The normalized car title based on option codes of the car.
e.g., Model 3 Long Range AWD
price
type: number
The price value of the car.
e.g., 53000
currency
type: string
The currency associated with the price of car.
See retrieve currencies for getting the full list currencies and symbols associated.
e.g., EUR
year
type: number
The manufactured year of the car.
e.g., 2020
odometer
type: number
The odometer value of the car.
e.g., 75813
odometerType
type: string
The type of the odometer value of the car. The value can be:
'kms'
'miles'
country
type: string
The Tesla inventory where the car is. The value can be:
'Austria'
(opens in a new tab)'Belgium'
(opens in a new tab)'Canada'
(opens in a new tab)'Switzerland'
(opens in a new tab)'Czechia'
(opens in a new tab)'Germany'
(opens in a new tab)'Denmark'
(opens in a new tab)'Spain'
(opens in a new tab)'Finland'
(opens in a new tab)'France'
(opens in a new tab)'United Kingdom'
(opens in a new tab)'Greece'
(opens in a new tab)'Croatia'
(opens in a new tab)'Hungary'
(opens in a new tab)'Ireland'
(opens in a new tab)'Iceland'
(opens in a new tab)'Italy'
(opens in a new tab)'Luxembourg'
(opens in a new tab)'Mexico'
(opens in a new tab)'Netherlands'
(opens in a new tab)'Norway'
(opens in a new tab)'Poland'
(opens in a new tab)'Puerto Rico'
(opens in a new tab)'Portugal'
(opens in a new tab)'Romania'
(opens in a new tab)'Sweden'
(opens in a new tab)'Slovenia'
(opens in a new tab)'United States'
(opens in a new tab)
optionCodes
type: string[]
The list of all the option codes of the car.
See retrieve option codes for getting the full list of option codes and descriptions associated.
e.g., ["AD15", "AF00", "APF1", "APH4", …]
buyUrl
type: string
The tesla.com (opens in a new tab) checkout URL to order the car.
e.g., 'https://www.tesla.com/it_IT/m3/order/…'
detailsUrl
type: string
The tesla.com (opens in a new tab) URL to see the rest of cars details on the web.
e.g., 'https://www.tesla.com/it_IT/m3/order/…'
createdAt
type: date
The ISO timestamp for the first time the car was seen.
e.g., '2022-04-06T08:24:28.000Z'
updatedAt
type: date
The ISO timestamp for the last time the car has been updated.
e.g., '2022-04-06T08:28:36.000Z'
modelLetter
type: string
The model letter that identified the model of the car. The value can be:
'S'
: The identifier for Model S cars.'3'
: The identifier for Model 3 cars'X'
: The identifier for Model X cars'Y'
: The identifier for Model Y cars
factoryDate
type: date
The ISO timestamp to represent the manufactured date of the car.
e.g., '2020-07-28T10:15:13.000Z'
priceHistory
type: object[]
A collection of the price evolution of the car over time.
e.g., [{ "price": 53000, "currency": "EUR", "date": 1649233468065 }]
condition
type: string
It represents the condition of the car. The value can be:
new
: The car is sell as new item.used
: The car is sell as used item.
tax
type: string | undefined
The tax rates associated with the car. The value can be:
-
undefined
: The car doesn't have taxes associated yet since the car is new. During buying process, the car will have the taxes associated with the origin country. Just resident companies in the country can buy the car. -
'vat'
: The car has refundable taxes associated. It can be trade as a business-to-business operation. You can claim the VAT in the origin country. -
'margin'
: The car hasn't refundable taxes associated. It will be trade as business-to-customer operation. You can't claim VAT in the origin country.
Archived attributes
These attributes are only present when the car has been sold.
isArchived
type: boolean
When it's present, it indicates the car is not available at Tesla inventories.
e.g., true
priceAvg
The average price for cars with similar characteristics.
type: number
e.g., 54450
priceMin
The mininum price for cars with similar characteristics.
type: number
e.g., 46700
priceMax
The maximum price for cars with similar characteristics.
type: number
e.g., 69000
odometerAvg
The average odometer value for cars with similar characteristics.
type: number
e.g., 22719
odometerMin
The mininum odometer value for cars with similar characteristics.
type: number
e.g., 10028
odometerMax
type: number
The maximum odometer value for cars with similar characteristics.
e.g., 101235