API: 
Delta Listing API
API Class: 
Delta Listing API
Description: 

Get classified ad listing details for a given classified ad id. The classified ad id must be passed in as part of the request url. For example, for the classified ad listing with id 12345, the request URL would be:

URL

Note: Ensure all testing is done in development environment prior to moving to production.

Environment URL
development https://api-st.cars.com/DeltaListingService/1.0/rest/listing/detail/[listingId]
production https://api.cars.com/DeltaListingService/1.0/rest/listing/detail/[listingId]

Request

Request Data Formats

N/A

Request Parameters

N/A

Link to Request XML Schema description

Response

Response Data Formats
Response type Header value
xml Accept: text/xml
json Accept: application/json
Response Elements
DeltaListingResult
Element Type Description
totalListings Integer Total number of listings
deltaListings DeltaListings Class description below
status Status Class description below
listingIds ListingIds Class description below
operationName String Operation name
stockType String Stock type code
DeltaListings
Element Type Description
deltaListing List: DeltaListing Class description below
DeltaListing
Element Type Description
classifiedAdId Long Classified Ad ID
vehicleIdNbr String Vehicle ID Number
vehicleStockNbr String Stock Number
vehicleStockType String Stock Type
vehicleListPrice BigDecimal List Price
vehicleYear String Year
vehicleMakeName String Make
vehicleModelName String Modle
vehicleTrim String Trim
vehicleBodyStyle String Body Style
vehicleDoorCount Integer Door Count
vehicleDriveTrainDscrp String Drive Train
vehicleEngineDscrp String Engine
vehicleExtrColorDscrp String Exterior Color
vehicleIntrColorDscrp String Interior Color
vehicleFuelTypeDscrp String Fuel Type
vehicleMileage Long Mileage
vehicleNavigationInd String Navigation
vehicleSeatCapacity String Seat Capacity
vehicleTransmissionDscrp String Transmission type
vehicleClassDscrp Object Vehicle Class
vehicleConditionDscrp String Vehicle Condition
vehicleWheelBase Integer Wheel Base size
vehicleStdFeatureSet String Standard feature set
vehicleOptnlFeatureSet String Optional feature set
vehicleSatelliteRadioType String Satellite radio type
addtSellPts String Additional selling points
maintDate String Maintained date
oneOwner String  
customerId Long Customer ID
displayCustomerName String Customer Name
addressLine1 String Address line 1
addressLine2 String Address line 2
city String City
state String State
postalCode String Postal code
latitude String Latitude
longitude String Longitude
phone1 String Phone number
phoneExt1 String Phone extension
phoneLabel1 String Phone label
phone2 String Phone number 2
phoneExt2 String Phone extension 2
phoneLabel2 String Phone label 2
dealerTagline String Dealer tagline
privatePartySellerInd String Private party seller ID
dlrLogoRdrctUrl String Dealer logo redirect URL
dlrWebsiteUrl String Dealer Website URL
adURL String Ad URL
adFromDate Long Ad from date
carfaxUrl String Carfax URL
adBestOfferInd String Ad Best Offer
emailLeadEnabled String Email lead enabled
certifiedPreOwnInd String CPO indicator
cpoProgramName String CPO program name
photos String Photos
actualPhotoCount Long Photo count
imageUrl String Image URL
superSizeImageUrl String Large Image URL
sellerVideoLocation String Seller video location
Status
Element Type Description
code Integer Status Code
message String Status Message
Response XML Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<deltaListingResult>
  <totalListings>1</totalListings>
  <deltaListings>
    <deltaListing>
      <classifiedAdId>123456</classifiedAdId>
      <vehicleIdNbr>ABCDEFG12345</vehicleIdNbr>
      <vehicleStockNbr>12345</vehicleStockNbr>
      <vehicleStockType>N</vehicleStockType>
      <vehicleListPrice>50000</vehicleListPrice>
      <vehicleYear>2013</vehicleYear>
      <vehicleMakeName>Chevrolet</vehicleMakeName>
      <vehicleModelName>Suburban</vehicleModelName>
      <vehicleTrim>1500 LTZ</vehicleTrim>
      <vehicleBodyStyle>SUV</vehicleBodyStyle>
      <vehicleDoorCount>4</vehicleDoorCount>
      <vehicleDriveTrainDscrp>4WD</vehicleDriveTrainDscrp>
      <vehicleEngineDscrp>5.3L V8 16V MPFI OHV</vehicleEngineDscrp>
      <vehicleExtrColorDscrp>White Diamond Tri-Coat</vehicleExtrColorDscrp>
      <vehicleIntrColorDscrp>Ebony</vehicleIntrColorDscrp>
      <vehicleFuelTypeDscrp>Gasoline</vehicleFuelTypeDscrp>
      <vehicleMileage>1</vehicleMileage>
      <vehicleNavigationInd>N</vehicleNavigationInd>
      <vehicleSeatCapacity>7or8</vehicleSeatCapacity>
      <vehicleTransmissionDscrp>6-Speed Automatic</vehicleTransmissionDscrp>
      <vehicleWheelBase>130</vehicleWheelBase>
      <vehicleStdFeatureSet>Fuel Consumption: City: 15 mpg, Fuel Consumption: Highway: 21 mpg,
      Memorized Settings including door...</vehicleStdFeatureSet>
      <vehicleOptnlFeatureSet>Engine Description: 5.30l V816v, Fuel Type: Flexible Fuel,
      Cam Type: Overhead Valve...</vehicleOptnlFeatureSet>
      <addtSellPts>This Ad Must Be Printed and Endorsed by ...</addtSellPts>
      <maintDate>2013-11-21T00:04:34-06:00</maintDate>
      <oneOwner>N</oneOwner>
      <customerId>12345</customerId>
      <displayCustomerName>Some Chevrolet</displayCustomerName>
      <addressLine1>1234 Some Road</addressLine1>
      <city>Uniontown</city>
      <state>PA</state>
      <postalCode>15401</postalCode>
      <latitude>39.943005</latitude>
      <longitude>-79.731086</longitude>
      <phone1>8889991212</phone1>
      <dealerTagline>Best. Car. Place. Ever.</dealerTagline>
      <privatePartySellerInd>N</privatePartySellerInd>
      <dlrWebsiteUrl>http://www.someurl.com</dlrWebsiteUrl>
      <adFromDate>12345</adFromDate>
      <adBestOfferInd>N</adBestOfferInd>
      <emailLeadEnabled>Y</emailLeadEnabled>
      <certifiedPreOwnInd>N</certifiedPreOwnInd>
      <photos>DMI/12345/L12345/01.jpg,...DMI/12345/L123467/32.jpg</photos>
      <actualPhotoCount>32</actualPhotoCount>
      <imageUrl>http://images.cars.com/phototab/</imageUrl>
      <superSizeImageUrl>http://images.cars.com/supersized/</superSizeImageUrl>
      <sellerVideoLocation>http://video.dmotorworks.com/video/CarVideo.html?LTVAutoPlay=1&amp;w=583&amp;h=425&amp;vid=ABCDEF12345</sellerVideoLocation>
    </deltaListing>
  </deltaListings>
  <operationName>DETAIL</operationName>
</deltaListingResult>
		
Response JSON example
{"DeltaListingResult":
  {
    "totalListings": 1,
    "deltaListings": {
      "deltaListing": [
      {
       "classifiedAdId": 123456,
       "vehicleIdNbr": "ABCDEFG12345",
       "vehicleStockNbr": "12345",
       "vehicleStockType": "N",
       "vehicleListPrice": 50000,
       "vehicleYear": "2013",
       "vehicleMakeName": "Chevrolet",
       "vehicleModelName": "Suburban",
       "vehicleTrim": "1500 LTZ",
       "vehicleBodyStyle": "SUV",
       "vehicleDoorCount": 4,
       "vehicleDriveTrainDscrp": "4WD",
       "vehicleEngineDscrp": "5.3L V8 16V MPFI OHV",
       "vehicleExtrColorDscrp": "White Diamond Tri-Coat",
       "vehicleIntrColorDscrp": "Ebony",
       "vehicleFuelTypeDscrp": "Gasoline",
       "vehicleMileage": 1,
       "vehicleNavigationInd": "N",
       "vehicleSeatCapacity": "7or8",
       "vehicleTransmissionDscrp": "6-Speed Automatic",
       "vehicleWheelBase": 130,
       "vehicleStdFeatureSet": "Fuel Consumption: City: 15 mpg, Fuel Consumption: Highway: 21 mpg,
       Memorized Settings including door...",
       "vehicleOptnlFeatureSet": "Engine Description: 5.30l V816v, Fuel Type: Flexible Fuel,
       Cam Type: Overhead Valve...",
       "addtSellPts": "This Ad Must Be Printed and Endorsed by...",
       "maintDate": "2013-11-21T00:04:34-06:00",
       "oneOwner": "N",
       "customerId": 12345,
       "displayCustomerName": "Some Chevrolet",
       "addressLine1": "12435 Some Road",
       "city": "Somecity",
       "state": "PA",
       "postalCode": "12345",
       "latitude": "39.943005",
       "longitude": "-79.731086",
       "phone1": "8889991212",
       "dealerTagline": "Best. Car. Place. Ever.",
       "privatePartySellerInd": "N",
       "dlrWebsiteUrl": "http://www.someurl.com",
       "adFromDate": 12345,
       "adBestOfferInd": "N",
       "emailLeadEnabled": "Y",
       "certifiedPreOwnInd": "N",
       "photos": "DMI/12345/L12345/01.jpg,DMI/12345/L12346/02.jpg,...DMI/12345/L123467/32.jpg",
       "actualPhotoCount": 32,
       "imageUrl": "http://images.cars.com/phototab/",
       "superSizeImageUrl": "http://images.cars.com/supersized/",
       "sellerVideoLocation": "http://video.dmotorworks.com/video/CarVideo.html?LTVAutoPlay=1&w=583&h=425&vid=ABCDEF12345"
     }]
   },
    "operationName": "DETAIL"
 }
}
Test
Method Type: 
GET
Endpoint URI: 
https://api-st.cars.com/DeltaListingService/1.0/rest/listing/detail/[listingId]
Request: 
?apikey=ABCDE12345