Cars
The car object

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:

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