Vehicle listingsresult.data.listings | array | The returned vehicle collection. Its length can differ from the separate listing total. |
|---|
VINresult.data.listings[].vin | string | The VIN identifying this listing; keep it as supplied when comparing vehicles. |
|---|
Model yearresult.data.listings[].year | number | The vehicle’s model year, rather than its manufacture or registration date. |
|---|
Makeresult.data.listings[].make | string | The make shown for this vehicle. |
|---|
Modelresult.data.listings[].model | string | The model shown for this vehicle. |
|---|
Trimresult.data.listings[].trim | string | The trim or configuration version; confirm the equipment on the actual vehicle. |
|---|
Body typeresult.data.listings[].bodytype | string | The vehicle’s body-style label, such as Sedan. |
|---|
New or usedresult.data.listings[].vehicleCondition | string | The listing’s new/used label. New does not guarantee zero mileage. |
|---|
Fuel typeresult.data.listings[].fuel | string | The fuel or propulsion type shown for the vehicle. |
|---|
Engineresult.data.listings[].engine | string | The engine description supplied with the listing. |
|---|
Transmissionresult.data.listings[].transmission | string | The transmission type shown for the vehicle. |
|---|
Drive typeresult.data.listings[].drivetype | string | The vehicle’s drive-layout label. |
|---|
Mileageresult.data.listings[].mileage | number | The mileage value when supplied. A missing value is not zero; confirm the unit. |
|---|
Current price valueresult.data.listings[].currentPrice | number | The value labelled current price in the listing. Confirm currency and the dealer’s current price; zero needs clarification. |
|---|
Listing priceresult.data.listings[].listPrice | number | The listing-price value, which may differ from the other price values. |
|---|
MSRPresult.data.listings[].msrp | number | The manufacturer’s suggested retail price value shown in the listing, distinct from the sale price. |
|---|
Vehicle priceresult.data.listings[].vehiclePrice | number | A separate vehicle-price value. Check which fees it includes. |
|---|
All-in price flagresult.data.listings[].allInPrice | boolean | Whether the price is marked as all-in. This is a flag, not an amount or a guarantee that all taxes and fees are included. |
|---|
Listing linkresult.data.listings[].vdpUrl | string | The vehicle’s listing-page link; use it to follow up on that vehicle. |
|---|
Exterior colorresult.data.listings[].exteriorColor | string | The exterior color listed for the vehicle. |
|---|
Interior colorresult.data.listings[].interiorColor | string | The interior color listed for the vehicle. |
|---|
First seenresult.data.listings[].firstSeen | string | The date text showing when the listing was first seen; it does not establish current availability. |
|---|
Dealer detailsresult.data.listings[].dealer | object | The dealer contact information attached to this listing. |
|---|
Dealer nameresult.data.listings[].dealer.name | string | The dealer’s name. |
|---|
Dealer addressresult.data.listings[].dealer.address | string | The dealer’s street-address text. |
|---|
Dealer cityresult.data.listings[].dealer.city | string | The city in the dealer’s address. |
|---|
Dealer stateresult.data.listings[].dealer.state | string | The state label in the dealer’s address. |
|---|
Dealer ZIP coderesult.data.listings[].dealer.zip | string | The dealer’s ZIP code as text. |
|---|
Dealer phoneresult.data.listings[].dealer.phone | string | The dealer phone number as supplied. |
|---|
CARFAX dealer linkresult.data.listings[].dealer.cfxMicrositeUrl | string | The dealer’s CARFAX page, distinct from the vehicle listing page. |
|---|
Photo versionsresult.data.listings[].images | object | Available photo-link versions and associated metadata; these do not establish a complete gallery. |
|---|
Small photo linksresult.data.listings[].images.small | array | Photo links grouped under small, when supplied. |
|---|
Medium photo linksresult.data.listings[].images.medium | array | Photo links grouped under medium, when supplied. |
|---|
Large photo linksresult.data.listings[].images.large | array | Photo links grouped under large, when supplied. |
|---|
Extra-large photo linksresult.data.listings[].images.xlarge | array | Photo links grouped under xlarge, when supplied; this group can be absent. |
|---|
Photo countresult.data.listings[].imageCount | number | The photo count attached to the listing, which may exceed the links returned. |
|---|
Listed equipmentresult.data.listings[].topOptions | array | Equipment descriptions listed for the vehicle; confirm installation on the actual vehicle. |
|---|
Fee entriesresult.data.listings[].fees | array | Fee labels and amounts. Entries may overlap or include a total and its components; confirm before adding them. |
|---|
Fee amountresult.data.listings[].fees[].fee | number | The amount paired with a fee label; confirm currency and whether it overlaps another entry. |
|---|
Fee typeresult.data.listings[].fees[].feeType | string | The fee label, which may overlap other labels for the same charge. |
|---|
Payment estimateresult.data.listings[].monthlyPaymentEstimate | object | The payment estimate and assumptions supplied with the listing. Some amounts may be absent; this is not a personalized lender offer. |
|---|
Search arearesult.data.searchArea | object | The area information attached to the search result. |
|---|
Search ZIP coderesult.data.searchArea.zip | string | The ZIP code shown in the returned search area. |
|---|
Search cityresult.data.searchArea.city | string | The city shown in the returned search area. |
|---|
Search stateresult.data.searchArea.state | string | The state label shown in the returned search area. |
|---|
Radius valueresult.data.searchArea.radius | number | The search-area radius value. Confirm its unit; it is not an additional input control. |
|---|
Listing totalresult.data.totalListingCount | number | The source’s listing total, separate from the number returned; it does not establish complete current inventory. |
|---|