API: 
Inventory Search API
API Class: 
Inventory Search API
Description: 

This operation takes an inventory listing id as input and returns details for the requested inventory.

Request

Request Data Formats
Request type Header value
xml Content-type: text/xml
Request XML Elements
Element Type Description
listingId Integer Inventory listing id
Request XML Example
		<listingDetailsRequest>
			<listingDetailsRequest>
			<listingId>79785223</listingId>
		</listingDetailsRequest>

Response

Response Data Formats
Response type Header value
xml Accept: text/xml
Response Elements
ListingDetailsResponse
Element Type Description
listingDetail List: ListingDetail See class description below
returnCode ReturnCode See class description below
ListingDetail
Element Type Description
id Long ID
makeName String Make
makeId Long Make ID
modelName String Model
modelId Long Model ID
modelYear Integer Year
modelYearId Long Year ID
trimName String Trim
trimId Long Trim ID
price Integer Price
miles Integer Mileage
exteriorColor String Exterior color
actualPhotoCount Integer Photo count
phoneNumber String Phone number
ringToPhoneNumber String Ring to phone number
city String City
cpoVehicle Boolean CPO vehicle boolean
sellerId Long Seller ID
sellerHasUsedDealerSpecialsEnabled Boolean Dealer specials boolean
bodystyleName String Body Style
dealerName String Dealer Name
doorCount Integer Number of doors
engineDescription String Engine
privatePartyContactName String Private party contact name
sellerHasCpoShowroomEnabled Boolean Seller has CPO showroom boolean
privatePartyListing Boolean Private party listing
listingDateSeconds Long Listing Date
listingTypeId Integer Listing type ID
sellerHasNewDealerSpecialsEnabled Boolean Seller has new dealer specials boolean
emailLeadEnabled Boolean Email Lead boolean
newCarStockType Boolean New car
state String State
stockNumber String Stock number
transmission String Transmission type
vin String Vin number
drivetrain String Drive train type
affiliateAgentId Long Affilate agent ID
primaryFeedSourceId Long Primary feed source ID
sellerName String Seller name
sellerEmailAddress String Seller email
sellerDisplayLabel String Seller display label
newlyListed Boolean Newly listed boolean
vehicleHistoryReportIsFree Boolean Vehicle history report is free boolean
certifiedPlus Boolean Certified plus boolean
ncSpotLight String NC Spotlight
dealerWebsiteUrl String Dealer website URL
streetAddress String Street address
customerId Long Customer ID
sellerHasDealerGroupEnabled Boolean Seller has dealer group enabled boolean
interiorColor String Interior color
dealerLogoImageLocation String Dealer logo image location
modelPackageName String Model package name
oneOwner Boolean One owner boolean
sellerAcceptsBestOffer Boolean Seller accepts best offer boolean
stockPhotoText String Stock photo text
satelliteRadioProvider String Satellite radio provider
standardFeatures String Standard features
bodystyleId Long Body style ID
wheelbase String Wheelbase
zipcode String Zip code
location String Latitude, Longitude location
sellerHasDealerChatEnabled Boolean Seller has dealer chat enabled boolean
hasOnStar Boolean Has On Star boolean
additionalSellingPoints String Additional selling points
listingSource String Listing source
adHistoryId Long Ad history ID
fuelType String Fuel type
mpgCity String Miles per gallon city
mpgHwy String Miles per gallon highway
seatCapacity String Seat capacity
ReturnCode
Response Field Name Type Description
code String Return Code
message String Return code message
Response XML Example
<searchResultBO>
  <listingDetailsResponse>
    <listingDetails>
      <listingDetail>
        <id>12345678</id>
        <makeName>Audi</makeName>
        <makeId>20049</makeId>
        <modelName>A4</modelName>
        <modelId>12345</modelId>
        <modelYear>2012</modelYear>
        <modelYearId>123456</modelYearId>
        <trimName>2.0T quattro Premium</trimName>
        <trimId>123456</trimId>
        <price>46550</price>
        <miles>12</miles>
        <exteriorColor>Phantom</exteriorColor>
        <actualPhotoCount>0</actualPhotoCount>
        <phoneNumber>8889991212</phoneNumber>
        <ringToPhoneNumber>8880001212</ringToPhoneNumber>
        <city>Naperville</city>
        <cpoVehicle>false</cpoVehicle>
        <sellerId>12345</sellerId>
        <sellerHasUsedDealerSpecialsEnabled>true</sellerHasUsedDealerSpecialsEnabled>
        <bodystyleName>Sedan</bodystyleName>
        <dealerName>Audi of Somewhere</dealerName>
        <doorCount>4</doorCount>
        <engineDescription>2.0L I4 16V GDI DOHC Turbo</engineDescription>
        <privatePartyContactName>Audi of Somewhere</privatePartyContactName>
        <sellerHasCpoShowroomEnabled>true</sellerHasCpoShowroomEnabled>
        <privatePartyListing>false</privatePartyListing>
        <listingDateSeconds>1323475200</listingDateSeconds>
        <listingTypeId>1</listingTypeId>
        <sellerHasNewDealerSpecialsEnabled>false</sellerHasNewDealerSpecialsEnabled>
        <emailLeadEnabled>true</emailLeadEnabled>
        <newCarStockType>true</newCarStockType>
        <state>IL</state>
        <stockNumber>BASE123</stockNumber>
        <transmission>8-Speed Automatic</transmission>
        <vin>ABCDEFG12345</vin>
        <drivetrain>AWD</drivetrain>
        <affiliateAgentId>0</affiliateAgentId>
        <primaryFeedSourceId>123</primaryFeedSourceId>
        <sellerName> Audi of Somewhere</sellerName>
        <sellerEmailAddress>some@email.com</sellerEmailAddress>
        <sellerDisplayLabel>Dealer</sellerDisplayLabel>
        <newlyListed>false</newlyListed>
        <vehicleHistoryReportIsFree>false</vehicleHistoryReportIsFree>
        <certifiedPlus>false</certifiedPlus>
        <ncSpotLight>N</ncSpotLight>
        <dealerWebsiteUrl>http://www.someurl.com</dealerWebsiteUrl>
        <customerId>80801</customerId>
        <streetAddress>1234 Somewhere Ave.</streetAddress>
        <sellerHasDealerGroupEnabled>false</sellerHasDealerGroupEnabled>
        <interiorColor>Black</interiorColor>
        <dealerLogoImageLocation>12345.jpg</dealerLogoImageLocation>
        <modelPackageName>2.0T quattro Premium</modelPackageName>
        <oneOwner>false</oneOwner>
        <sellerAcceptsBestOffer>false</sellerAcceptsBestOffer>
        <standardFeatures>Fuel Consumption: City: 21, Fuel Consumption: ...</standardFeatures>
        <bodystyleId>12345</bodystyleId>
        <wheelbase>111</wheelbase>
        <zipcode>12345</zipcode>
        <location>41.765502,-88.182929</location>
        <sellerHasDealerChatEnabled>true</sellerHasDealerChatEnabled>
        <hasOnStar>false</hasOnStar>
        <additionalSellingPoints>For additional information please contact...</additionalSellingPoints>
        <listingSource>Some source</listingSource>
        <adHistoryId>123451234</adHistoryId>
        <fuelType>Gasoline</fuelType>
        <mpgCity>21</mpgCity>
        <mpgHwy>31</mpgHwy>
        <seatCapacity>5</seatCapacity>
      </listingDetail>
    </listingDetails>
  </listingDetailsResponse>
</searchResultBO>
Test
Method Type: 
POST
Endpoint URI: 
https://api.cars.com/InventorySearchService/1.0/rest/inventory/listing