### List Deals by Advertiser Source: https://developers.autotrader.co.uk/deals An example HTTP GET request to list deals for a specific advertiser, including pagination and date filtering. ```HTTP GET /deals?advertiserId=123456&page=1&from=2023-05-05 ``` -------------------------------- ### Finance Search API Request Source: https://developers.autotrader.co.uk/index This snippet shows an example GET request to the Finance Search API, including parameters for finance options, minimum and maximum monthly prices, and advertiser ID. ```HTTP GET /search?financeOption=10000_1000_36&minMonthlyPrice=200&maxMonthlyPrice=500&advertiserId=1234 ``` -------------------------------- ### List Deals by Advertiser Source: https://developers.autotrader.co.uk/index An example HTTP GET request to list deals for a specific advertiser, including pagination and date filtering. ```HTTP GET /deals?advertiserId=123456&page=1&from=2023-05-05 ``` -------------------------------- ### Example Messages Resource Source: https://developers.autotrader.co.uk/deals An example JSON response for the Messages API, showing consumer and advertiser read statuses, and a list of messages with sender, timestamp, and content. ```JSON { "messagesId": "4ae0fc61-f92f-4fa6-9cd5-a8f31a2616c7", "consumerLastRead": "2023-05-02T18:58:39.608Z", "consumerLastReadStatus": "Read", "advertiserLastRead": "2023-05-02T18:58:54.398Z", "advertiserLastReadStatus": "Unread", "messages": [ { "from": "Consumer", "at": "2023-04-27T13:49:46.624Z", "message": "I'll decide later on delivery. Please could you contact me back?" }, { "from": "Advertiser", "at": "2023-05-02T18:55:26.469Z", "message": "I've called and left a message. Will try again after lunch." }, { "from": "Consumer", "at": "2023-05-02T19:00:49.194Z", "message": "What time do you close tonight?" } ] } ``` -------------------------------- ### Finance Search API Request Source: https://developers.autotrader.co.uk/api This snippet shows an example GET request to the Finance Search API, including parameters for finance options, minimum and maximum monthly prices, and advertiser ID. ```HTTP GET /search?financeOption=10000_1000_36&minMonthlyPrice=200&maxMonthlyPrice=500&advertiserId=1234 ``` -------------------------------- ### Retrieve Stock with Valuations Source: https://developers.autotrader.co.uk/index This example shows how to include valuation data for stock by adding `valuations=true` to the GET request. It returns both market average and adjusted valuations. ```HTTP GET /stock?valuations=true&advertiserId=123456 ``` -------------------------------- ### Retrieve Stock with Response Metrics Source: https://developers.autotrader.co.uk/index This example shows how to include response metrics when requesting stock data. Adding `responseMetrics=true` to the GET request provides advertising performance data for the stock. ```HTTP GET /stock?advertiserId=1234&responseMetrics=true ``` -------------------------------- ### Get Finance Application (GET) Source: https://developers.autotrader.co.uk/deals Retrieve details of a specific finance application by sending a GET request to /finance/applications/{applicationId}. Requires advertiserId and the applicationId. The response provides comprehensive details about the application, applicant, and finance terms. ```HTTP GET /finance/applications/{applicationId}?advertiserId=123456 ``` -------------------------------- ### Retrieve Stock with Valuations Source: https://developers.autotrader.co.uk/api This example shows how to include valuation data for stock by adding `valuations=true` to the GET request. It returns both market average and adjusted valuations. ```HTTP GET /stock?valuations=true&advertiserId=123456 ``` -------------------------------- ### Retrieve Stock with Response Metrics Source: https://developers.autotrader.co.uk/api This example shows how to include response metrics when requesting stock data. Adding `responseMetrics=true` to the GET request provides advertising performance data for the stock. ```HTTP GET /stock?advertiserId=1234&responseMetrics=true ``` -------------------------------- ### List Deals by Advertiser Source: https://developers.autotrader.co.uk/api This snippet shows how to list all deals for a specific advertiser using the Auto Trader Deals API. It includes the base URL for the sandbox and production environments, along with an example GET request with query parameters for advertiser ID and pagination. ```HTTP GET /deals?advertiserId=123456&page=1&from=2023-05-05 ``` -------------------------------- ### Deal Object Structure Source: https://developers.autotrader.co.uk/deals An example JSON response representing a single deal, including details about the consumer, stock, pricing, finance, part exchange, and messages. ```JSON { "results": [ { "dealId": "4ae0fc61-f92f-4fa6-9cd5-a8f31a2616c7", "advertiserId": "526502", "created": "2023-05-05T15:44:20.216Z", "lastUpdated": "2023-05-05T15:44:56.71Z", "advertiserDealStatus": "Cancelled", "advertiserCancellationReason": "Unaffordable", "advertiserCancellationNotes": "Customer can't raise deposit", "consumerDealStatus": "In Progress", "consumerReservationFeeStatus": "Refunded", "consumerCancellationReason": null, "consumerCancellationNotes": null, "consumer": { "firstName": "Test", "lastName": "User", "type": null, "tradingName": null, "vatRegistrationStatus": "Unknown", "email": "test.user@autotrader.co.uk", "phone": null }, "stock": { "stockId": "8a468e9585de69e40185df91b5d87ef9", "searchId": "202201237828809", "reservationStatus": "Reserved" }, "price": { "suppliedPrice": { "amountGBP": 17990 }, "adminFee": { "amountGBP": 100 }, "totalPrice": { "amountGBP": 18090 } }, "financeApplication": { "id": "26dcfa9f-d80e-4bf7-ab29-c491766e4886", "lastUpdated": "2024-10-03T15:27:36Z" }, "partExchange": { "id": "87fd5f48-56bc-47f3-b5ac-f722c271687c", "lastUpdated": "2024-09-01T15:27:36Z" }, "messages": { "id": "4ae0fc61-f92f-4fa6-9cd5-a8f31a2616c7", "lastUpdated": "2024-10-03T15:27:36Z" }, "calls": { "id": null, "lastUpdated": null }, "delivery": { "id": "4ae0fc61-f92f-4fa6-9cd5-a8f31a2616c7", "lastUpdated": "2024-10-01T15:27:36Z" } } ], "totalResults": 24 } ``` -------------------------------- ### Vehicle Features Response Example Source: https://developers.autotrader.co.uk/index Example JSON response for a vehicle features request, detailing various attributes like name, type, price, and factory codes for each feature. ```JSON { "vehicle":{...}, "features":[ { "name":"12V Power Socket - Passenger Footwell", "genericName":"12V Socket - Front", "type":"Standard", "category":"Audio and Communications", "basicPrice":0.0, "vatPrice":0.0, "factoryCodes":[], "rarityRating":null, "valueRating":null, "factoryFitted":null }, { "name":"17in Alloy Wheels - Light Star Spoke - 379", "genericName":"Wheels - 17in Alloys", "type":"Optional", "category":"Exterior", "basicPrice":0.0, "vatPrice":0.0, "factoryCodes":["415"], "rarityRating":"Rare", "valueRating":null, "factoryFitted":true }, { "name":"Adaptive LED Headlights with High-Beam Assistant", "genericName":"Headlights - Adaptive Forward", "type":"Optional", "category":"Illumination", "basicPrice":991.67, "vatPrice":198.33, "factoryCodes":["3AC"], "rarityRating":null, "valueRating":"High Value", "factoryFitted":false }, { "name":"Bursting Blue", "genericName":"Blue", "type":"Optional", "category":"Paint", "basicPrice":708.33, "vatPrice":141.67, "factoryCodes":["123"], "rarityRating":null, "valueRating":null, "genericFinish":"Special Metallic", "finish":"Premium Metallic", "factoryFitted":false } ] } ``` -------------------------------- ### Historic Valuations API POST Request Example Source: https://developers.autotrader.co.uk/index Illustrates a successful POST request to the Historic Valuations API, including the endpoint and required parameters. ```HTTP POST /historic-valuations?advertiserId=123456 HTTP/1.1 ``` -------------------------------- ### Vehicle Data Structure Example Source: https://developers.autotrader.co.uk/api This JSON snippet represents a complete Auto Trader stock resource with example data. It includes details about the vehicle, advertiser, adverts, metadata, features, media, history, and provenance checks. ```json { "vehicle": { "ownershipCondition": "Used", "registration": "YO12XXX", "vin": "WAUZXXXXXXXXX12345", "engineNumber": "CZDA098683", "make": "Audi", "model": "A3", "generation": "Saloon (2020 - )", "derivative": "2.0 TDI 35 Sport Saloon 4dr Diesel S Tronic Euro 6 (s/s) (150 ps)", "derivativeId": "c8be64b89ccb445391c1c3c6d5e57fe5", "vehicleType": "Car", "trim": "Black Edition", "bodyType": "Saloon", "fuelType": "Diesel", "cabType": null, "transmissionType": "Automatic", "wheelbaseType": "LWB", "roofHeightType": "H2", "drivetrain": "Four Wheel Drive", "wheelchairAccessible": "Y", "seats": 5, "doors": 3, "valves": 16, "engineTorqueNM": 400, "co2EmissionGPKM": 102, "topSpeedMPH": 125, "zeroToSixtyMPHSeconds": 8.7 }, "advertiser": { "referenceId": "a1b2c3d4e5f678901234567890abcdef" }, "adverts": { "dealerAuctionAdvert": { "status": "NOT_PUBLISHED" }, "finance": { "amountOfCredit": { "amountGBP": 12900.0 }, "totalChargesPayable": { "amountGBP": 1000.0 }, "totalAmountPayable": { "amountGBP": 13900.0 }, "representativeAPR": 9.9, "fixedRateOfInterestPerAnnum": 10.1, "optionalFinalPayment": { "amountGBP": 3000.0 }, "optionToPurchaseFee": { "amountGBP": 500.0 }, "lender": "Lender Name", "excessCostPencePerMile": null, "orderedFrom": "2025-01-28", "orderedBy": "2025-03-28", "registeredBy": "2025-01-30", "startDate": "2025-01-28", "expiryDate": "2025-03-21" } }, "metadata": { "stockId": "8a46931b95d82bde0195d834737500bc", "searchId": "202503279320840", "externalStockId": null, "externalStockReference": null, "lastUpdated": "2025-03-27T15:34:21Z", "lastUpdatedByAdvertiser": "2025-03-27T15:34:21Z", "versionNumber": 4, "lifecycleState": "FORECOURT", "dateOnForecourt": "2025-03-27" }, "features": [], "highlights": [ { "name": "Number Owners One Previous" }, { "name": "Acceleration High" } ], "media": { "images": [], "video": { "href": null }, "spin": { "href": null } }, "history": { "scrapped": false, "stolen": false, "imported": false, "exported": false, "previousOwners": 1 }, "check": { "insuranceWriteoffCategory": null, "scrapped": false, "stolen": false, "imported": false, "exported": false, "privateFinance": null, "tradeFinance": null, "highRisk": null, "mileageDiscrepancy": null, "colourChanged": null, "registrationChanged": null, "previousOwners": 1 }, "totalResults": 1 } ``` -------------------------------- ### Call Details Response Source: https://developers.autotrader.co.uk/deals Example JSON response for retrieving call details. Includes the callsId, call timestamp (at), status, recording availability, and duration in seconds. ```JSON { "callsId": "ad07cfda-4d02-4068-b7a4-9af6132311a0", "calls": [ { "at": "2025-01-13T12:54:27Z", "status": "ANSWERED", "hasRecording": true, "durationSeconds": 14 } ] } ``` -------------------------------- ### Delivery Information Response Source: https://developers.autotrader.co.uk/deals Example JSON response for delivery details. Includes deliveryId, delivery method (e.g., Home Delivery, Click and Collect), and postcode. ```JSON { "deliveryId": "ad07cfda-4d02-4068-b7a4-9af6132311a1", "method": "Home Delivery", "postcode": "M154FN" } ``` -------------------------------- ### Autotrader API: Not Found Example (404) Source: https://developers.autotrader.co.uk/api Demonstrates a 'Not Found' (404) error, indicating that the requested resource, such as a specific stock item, could not be located. This example shows a missing stock item by ID. ```json { "message": "No stock found with the id {xxxx}" } ``` -------------------------------- ### Vehicle History Response Example Source: https://developers.autotrader.co.uk/index Example JSON response for a vehicle history request, showing boolean flags for status, number of previous owners, and lists of keeper and V5C dates. ```JSON { "vehicle":{...}, "history":{ "scrapped":false, "stolen":false, "imported":false, "exported":false, "previousOwners":3, "yearOfManufacture":2012, "keeperChanges":[ {"dateOfLastKeeper":"2016-08-30"}, {"dateOfLastKeeper":"2013-11-02"}, {"dateOfLastKeeper":"2012-07-25"} ], "v5cs":[ {"issuedDate":"2017-04-13"} ] } } ``` -------------------------------- ### Vehicle Features Response Example Source: https://developers.autotrader.co.uk/api Example JSON response for a vehicle features request, detailing various attributes like name, type, price, and factory codes for each feature. ```JSON { "vehicle":{...}, "features":[ { "name":"12V Power Socket - Passenger Footwell", "genericName":"12V Socket - Front", "type":"Standard", "category":"Audio and Communications", "basicPrice":0.0, "vatPrice":0.0, "factoryCodes":[], "rarityRating":null, "valueRating":null, "factoryFitted":null }, { "name":"17in Alloy Wheels - Light Star Spoke - 379", "genericName":"Wheels - 17in Alloys", "type":"Optional", "category":"Exterior", "basicPrice":0.0, "vatPrice":0.0, "factoryCodes":["415"], "rarityRating":"Rare", "valueRating":null, "factoryFitted":true }, { "name":"Adaptive LED Headlights with High-Beam Assistant", "genericName":"Headlights - Adaptive Forward", "type":"Optional", "category":"Illumination", "basicPrice":991.67, "vatPrice":198.33, "factoryCodes":["3AC"], "rarityRating":null, "valueRating":"High Value", "factoryFitted":false }, { "name":"Bursting Blue", "genericName":"Blue", "type":"Optional", "category":"Paint", "basicPrice":708.33, "vatPrice":141.67, "factoryCodes":["123"], "rarityRating":null, "valueRating":null, "genericFinish":"Special Metallic", "finish":"Premium Metallic", "factoryFitted":false } ] } ``` -------------------------------- ### Get Finance Application (GET) Source: https://developers.autotrader.co.uk/index Retrieve the details and status of a finance application using a GET request to the /finance/applications/{applicationId} endpoint. This requires the application ID and advertiser ID. ```HTTP GET /finance/applications/{applicationId}?advertiserId=123456 ``` -------------------------------- ### Historic Valuations API POST Request Example Source: https://developers.autotrader.co.uk/api Illustrates a successful POST request to the Historic Valuations API, including the endpoint and required parameters. ```HTTP POST /historic-valuations?advertiserId=123456 HTTP/1.1 ``` -------------------------------- ### Get Vehicle Valuations (GET) Source: https://developers.autotrader.co.uk/index Requests vehicle valuation data using a GET request. Requires registration, valuations=true, odometer reading, and advertiser ID. Returns detailed valuation breakdowns for trade, part exchange, retail, and private sales. ```HTTP GET /vehicles?registration=XXXXX&valuations=true&odometerReadingMiles=8000&advertiserId=123456 ``` -------------------------------- ### Auto Trader Stock API - Example Stock Record (JSON) Source: https://developers.autotrader.co.uk/index An example JSON object representing a stock record for a vehicle on the Auto Trader platform. This structure includes detailed information about the vehicle, advertiser, and advert details. ```JSON { "results": [ { "vehicle": { "ownershipCondition": "Used", "registration": "FG71WMC", "vin": "WF0TR3SU1MMA39540", "engineNumber": "MA39540", "make": "Ford", "model": "Mustang Mach-E", "generation": "SUV (2020 - )", "derivative": "Extended Range 91kWh SUV 5dr Electric Automatic AWD (351 ps)", "derivativeId": "5b8a3547223b4edc819fb1603395f6ec", "vehicleType": "Car", "trim": null, "bodyType": "SUV", "fuelType": "Electric", "cabType": null, "transmissionType": "Automatic", "wheelbaseType": "STD", "roofHeightType": null, "drivetrain": "Four Wheel Drive", "seats": 5, "doors": 5, "cylinders": 0, "valves": 0, "engineTorqueNM": 580, "co2EmissionGPKM": 0, "topSpeedMPH": 111, "zeroToSixtyMPHSeconds": null, "zeroToOneHundredKMPHSeconds": 5.8, "badgeEngineSizeLitres": null, "badgeEngineSizeCC": null, "engineCapacityCC": null, "enginePowerBHP": 346, "enginePowerPS": null, "fuelCapacityLitres": null, "emissionClass": "Euro 6", "owners": 1, "fuelEconomyNEDCExtraUrbanMPG": null, "fuelEconomyNEDCUrbanMPG": null, "fuelEconomyNEDCCombinedMPG": null, "fuelEconomyWLTPLowMPG": null, "fuelEconomyWLTPMediumMPG": null, "fuelEconomyWLTPHighMPG": null, "fuelEconomyWLTPExtraHighMPG": null, "fuelEconomyWLTPCombinedMPG": null, "bootSpaceSeatsUpLitres": 402.0, "bootSpaceSeatsDownLitres": 1420.0, "insuranceGroup": "40", "insuranceSecurityCode": "E", "firstRegistrationDate": "2021-11-10", "colour": "Blue", "style": null, "subStyle": null, "lengthMM": 4713, "heightMM": 1625, "widthMM": 2094, "wheelbaseMM": 3678, "payloadLengthMM": null, "payloadWidthMM": null, "payloadHeightMM": null, "payloadWeightKG": null, "minimumKerbWeightKG": 2182, "grossVehicleWeightKG": 2690, "batteryRangeMiles": 335, "batteryCapacityKWH": 98.7, "batteryUsableCapacityKWH": 91.0, "odometerReadingMiles": null, "motExpiryDate": null, "warrantyMonthsOnPurchase": null, "serviceHistory": null, "hoursUsed": null, "plate": "71", "yearOfManufacture": "2021", "interiorCondition": null, "tyreCondition": null, "bodyCondition": null, "exDemo": null, "v5Certificate": null, "previousOwners": 1, "driverPosition": "Unlisted", "axleConfiguration": null, "trailerAxleNumber": null, "upholstery": null, "interiorColour": null, "exteriorFinish": null, "lastServiceOdometerReadingMiles": null, "lastServiceDate": null, "chassisMake": null, "chassisModel": null, "bedroomLayout": null, "endLayout": null, "bedrooms": null, "berths": null, "wheelchairAccessible": null, "vehicleExciseDutyWithoutSupplementGBP": 0, "keys": null, "standard": { "make": "Ford", "model": "Mustang Mach-E", "generation": "SUV (2020 - )", "derivative": "Extended Range 91kWh AWD 5dr", "trim": null, "bodyType": "SUV", "fuelType": "Electric", "transmissionType": "Automatic", "cabType": "Unlisted", "drivetrain": "Four Wheel Drive", "colour": "Blue", "style": null, "subStyle": null, "cargoVolumeVDALitres": null } }, "advertiser": { "advertiserId": "77067", "name": "DR Call Enquiries", "segment": "Franchise", "website": "http://www.autotrader.co.uk", "phone": "(01704) 468014", "location": { "addressLineOne": "First Street", "town": "MANCHESTER", "county": null, "region": "NORTH WEST", "postCode": "M15 4FN", "latitude": 53.4721936, "longitude": -2.24703 }, "advertStrapline": "Strapline thing" }, "adverts": { "forecourtPrice": { "amountGBP": null }, "soldPrice": { "amountGBP": null }, "forecourtPriceVatStatus": null, "vatScheme": null, "dueDate": null, "manufacturerApproved": false, "twelveMonthsMot": false, "motInsurance": null, "reservationStatus": null, "reservationDealId": null, "buyerPostcode": null, "retailAdverts": { "priceOnApplication": false, "suppliedPrice": { "amountGBP": null, "amountGBX": null }, "totalPrice": { "amountGBP": null }, "adminFee": { "amountGBP": 100 }, "adminFeeOverride": { "amountGBP": null }, "manufacturerRRP": { "amountGBP": null }, "vatStatus": null, "attentionGrabber": null, "description": null, "description2": null, "priceIndicatorRating": "LOW", "priceIndicatorRatingBands": { "LOW": { "from": 1500, "to": 21015 }, "GREAT": { "from": 21015, "to": 21679 }, "GOOD": { "from": 21679, "to": 22785 }, "FAIR": { "from": 22785, "to": 23891 }, "HIGH": { "from": 23891, "to": 70000 } }, "autotraderAdvert": { "status": "PUBLISHED", "eligibleContractAllowances": [ { "type": "Standard" } ], "allocatedContractAllowance": { "type": "Standard" } }, "advertiserAdvert": { "status": "NOT_PUBLISHED" }, "locatorAdvert": { "status": "NOT_PUBLISHED" }, "exportAdvert": { "status": "NOT_PUBLISHED" }, "profileAdvert": { "status": "NOT_PUBLISHED" }, "displayOptions": { "excludePreviousOwners": false, "excludeStrapline": false, "excludeMot": false, "excludeWarranty": false, "excludeInteriorDetails": false, "excludeTyreCondition": false, "excludeBodyCondition": false }, "financeOffers": { "headlineOffer": { "product": "CS", "monthlyPayment": { "amountGBP": 129.1 }, "contractLengthMonths": 60, "termMonths": 60, "annualMileage": 10000, "lenderDeposit": { "amountGBP": 0.0 }, "advertiserDeposit": { "amountGBP": 0.0 }, "consumerDeposit": { "amountGBP": 1000.0 }, "minimumDepositPe": null } } } } } ] } ``` -------------------------------- ### Vehicle History Response Example Source: https://developers.autotrader.co.uk/api Example JSON response for a vehicle history request, showing boolean flags for status, number of previous owners, and lists of keeper and V5C dates. ```JSON { "vehicle":{...}, "history":{ "scrapped":false, "stolen":false, "imported":false, "exported":false, "previousOwners":3, "yearOfManufacture":2012, "keeperChanges":[ {"dateOfLastKeeper":"2016-08-30"}, {"dateOfLastKeeper":"2013-11-02"}, {"dateOfLastKeeper":"2012-07-25"} ], "v5cs":[ {"issuedDate":"2017-04-13"} ] } } ``` -------------------------------- ### Auto Trader Stock API - Example Stock Record (JSON) Source: https://developers.autotrader.co.uk/api An example JSON object representing a stock record for a vehicle on the Auto Trader platform. This structure includes detailed information about the vehicle, advertiser, and advert details. ```JSON { "results": [ { "vehicle": { "ownershipCondition": "Used", "registration": "FG71WMC", "vin": "WF0TR3SU1MMA39540", "engineNumber": "MA39540", "make": "Ford", "model": "Mustang Mach-E", "generation": "SUV (2020 - )", "derivative": "Extended Range 91kWh SUV 5dr Electric Automatic AWD (351 ps)", "derivativeId": "5b8a3547223b4edc819fb1603395f6ec", "vehicleType": "Car", "trim": null, "bodyType": "SUV", "fuelType": "Electric", "cabType": null, "transmissionType": "Automatic", "wheelbaseType": "STD", "roofHeightType": null, "drivetrain": "Four Wheel Drive", "seats": 5, "doors": 5, "cylinders": 0, "valves": 0, "engineTorqueNM": 580, "co2EmissionGPKM": 0, "topSpeedMPH": 111, "zeroToSixtyMPHSeconds": null, "zeroToOneHundredKMPHSeconds": 5.8, "badgeEngineSizeLitres": null, "badgeEngineSizeCC": null, "engineCapacityCC": null, "enginePowerBHP": 346, "enginePowerPS": null, "fuelCapacityLitres": null, "emissionClass": "Euro 6", "owners": 1, "fuelEconomyNEDCExtraUrbanMPG": null, "fuelEconomyNEDCUrbanMPG": null, "fuelEconomyNEDCCombinedMPG": null, "fuelEconomyWLTPLowMPG": null, "fuelEconomyWLTPMediumMPG": null, "fuelEconomyWLTPHighMPG": null, "fuelEconomyWLTPExtraHighMPG": null, "fuelEconomyWLTPCombinedMPG": null, "bootSpaceSeatsUpLitres": 402.0, "bootSpaceSeatsDownLitres": 1420.0, "insuranceGroup": "40", "insuranceSecurityCode": "E", "firstRegistrationDate": "2021-11-10", "colour": "Blue", "style": null, "subStyle": null, "lengthMM": 4713, "heightMM": 1625, "widthMM": 2094, "wheelbaseMM": 3678, "payloadLengthMM": null, "payloadWidthMM": null, "payloadHeightMM": null, "payloadWeightKG": null, "minimumKerbWeightKG": 2182, "grossVehicleWeightKG": 2690, "batteryRangeMiles": 335, "batteryCapacityKWH": 98.7, "batteryUsableCapacityKWH": 91.0, "odometerReadingMiles": null, "motExpiryDate": null, "warrantyMonthsOnPurchase": null, "serviceHistory": null, "hoursUsed": null, "plate": "71", "yearOfManufacture": "2021", "interiorCondition": null, "tyreCondition": null, "bodyCondition": null, "exDemo": null, "v5Certificate": null, "previousOwners": 1, "driverPosition": "Unlisted", "axleConfiguration": null, "trailerAxleNumber": null, "upholstery": null, "interiorColour": null, "exteriorFinish": null, "lastServiceOdometerReadingMiles": null, "lastServiceDate": null, "chassisMake": null, "chassisModel": null, "bedroomLayout": null, "endLayout": null, "bedrooms": null, "berths": null, "wheelchairAccessible": null, "vehicleExciseDutyWithoutSupplementGBP": 0, "keys": null, "standard": { "make": "Ford", "model": "Mustang Mach-E", "generation": "SUV (2020 - )", "derivative": "Extended Range 91kWh AWD 5dr", "trim": null, "bodyType": "SUV", "fuelType": "Electric", "transmissionType": "Automatic", "cabType": "Unlisted", "drivetrain": "Four Wheel Drive", "colour": "Blue", "style": null, "subStyle": null, "cargoVolumeVDALitres": null } }, "advertiser": { "advertiserId": "77067", "name": "DR Call Enquiries", "segment": "Franchise", "website": "http://www.autotrader.co.uk", "phone": "(01704) 468014", "location": { "addressLineOne": "First Street", "town": "MANCHESTER", "county": null, "region": "NORTH WEST", "postCode": "M15 4FN", "latitude": 53.4721936, "longitude": -2.24703 }, "advertStrapline": "Strapline thing" }, "adverts": { "forecourtPrice": { "amountGBP": null }, "soldPrice": { "amountGBP": null }, "forecourtPriceVatStatus": null, "vatScheme": null, "dueDate": null, "manufacturerApproved": false, "twelveMonthsMot": false, "motInsurance": null, "reservationStatus": null, "reservationDealId": null, "buyerPostcode": null, "retailAdverts": { "priceOnApplication": false, "suppliedPrice": { "amountGBP": null, "amountGBX": null }, "totalPrice": { "amountGBP": null }, "adminFee": { "amountGBP": 100 }, "adminFeeOverride": { "amountGBP": null }, "manufacturerRRP": { "amountGBP": null }, "vatStatus": null, "attentionGrabber": null, "description": null, "description2": null, "priceIndicatorRating": "LOW", "priceIndicatorRatingBands": { "LOW": { "from": 1500, "to": 21015 }, "GREAT": { "from": 21015, "to": 21679 }, "GOOD": { "from": 21679, "to": 22785 }, "FAIR": { "from": 22785, "to": 23891 }, "HIGH": { "from": 23891, "to": 70000 } }, "autotraderAdvert": { "status": "PUBLISHED", "eligibleContractAllowances": [ { "type": "Standard" } ], "allocatedContractAllowance": { "type": "Standard" } }, "advertiserAdvert": { "status": "NOT_PUBLISHED" }, "locatorAdvert": { "status": "NOT_PUBLISHED" }, "exportAdvert": { "status": "NOT_PUBLISHED" }, "profileAdvert": { "status": "NOT_PUBLISHED" }, "displayOptions": { "excludePreviousOwners": false, "excludeStrapline": false, "excludeMot": false, "excludeWarranty": false, "excludeInteriorDetails": false, "excludeTyreCondition": false, "excludeBodyCondition": false }, "financeOffers": { "headlineOffer": { "product": "CS", "monthlyPayment": { "amountGBP": 129.1 }, "contractLengthMonths": 60, "termMonths": 60, "annualMileage": 10000, "lenderDeposit": { "amountGBP": 0.0 }, "advertiserDeposit": { "amountGBP": 0.0 }, "consumerDeposit": { "amountGBP": 1000.0 }, "minimumDepositPe": null } } } } } ] } ``` -------------------------------- ### Autotrader API: Successful Response Example (200/201) Source: https://developers.autotrader.co.uk/api Illustrates a successful API response, often returning vehicle data or stock item information. This example shows a 200 status with a warning indicating a rejected stock item due to pricing. ```json { "...warnings": [ { "type": "ERROR", "feature": "stock", "message": "Rejected due to price of null not meeting minimum price of 75" } ], "vehicle": { ... } } ``` -------------------------------- ### Image URL with Resize Parameter Source: https://developers.autotrader.co.uk/deprecated Provides an example of an image URL structure used by Auto Trader, including the default '{resize}' parameter and how to specify custom dimensions. ```JSON {"autotraderAllocated":false,"_links":{"self":{"href":"https://m.atcdn.co.uk/a/media/{resize}/12345abc125848454.jpg","templated":true}}} ``` -------------------------------- ### Autotrader API: Conflict Example (409) Source: https://developers.autotrader.co.uk/api This section describes the 'Conflict' (409) status code, which is typically returned when the request cannot be completed due to a conflict with the current state of the resource. Specific examples are not provided in the source text. -------------------------------- ### Search Advert by Finance Option Source: https://developers.autotrader.co.uk/deprecated Demonstrates how to search for adverts using the 'finance_option' parameter, which accepts mileage, deposit, and terms. Includes an example API call. ```HTTP https://api-sandbox.autotrader.co.uk/service/search1/advert?finance_option=10000_5000_36&size=10 ``` -------------------------------- ### List Facet Information for Advert Searches Source: https://developers.autotrader.co.uk/deprecated Shows how to retrieve facet information for advert searches by making a GET request to the advert endpoint. ```HTTP GET /service/search1/advert HTTP/1.1 Content-Type: application/json Authorization: Bearer {access_token} ``` -------------------------------- ### Deal Object Structure Source: https://developers.autotrader.co.uk/index An example JSON response representing a single deal, including details about the consumer, stock, pricing, finance, part exchange, and messages. ```JSON { "results": [ { "dealId": "4ae0fc61-f92f-4fa6-9cd5-a8f31a2616c7", "advertiserId": "526502", "created": "2023-05-05T15:44:20.216Z", "lastUpdated": "2023-05-05T15:44:56.71Z", "advertiserDealStatus": "Cancelled", "advertiserCancellationReason": "Unaffordable", "advertiserCancellationNotes": "Customer can't raise deposit", "consumerDealStatus": "In Progress", "consumerReservationFeeStatus": "Refunded", "consumerCancellationReason": null, "consumerCancellationNotes": null, "consumer": { "firstName": "Test", "lastName": "User", "type": null, "tradingName": null, "vatRegistrationStatus": "Unknown", "email": "test.user@autotrader.co.uk", "phone": null }, "stock": { "stockId": "8a468e9585de69e40185df91b5d87ef9", "searchId": "202201237828809", "reservationStatus": "Reserved" }, "price": { "suppliedPrice": { "amountGBP": 17990 }, "adminFee": { "amountGBP": 100 }, "totalPrice": { "amountGBP": 18090 } }, "financeApplication": { "id": "26dcfa9f-d80e-4bf7-ab29-c491766e4886", "lastUpdated": "2024-10-03T15:27:36Z" }, "partExchange": { "id": "87fd5f48-56bc-47f3-b5ac-f722c271687c", "lastUpdated": "2024-09-01T15:27:36Z" }, "messages": { "id": "4ae0fc61-f92f-4fa6-9cd5-a8f31a2616c7", "lastUpdated": "2024-10-03T15:27:36Z" }, "calls": { "id": null, "lastUpdated": null }, "delivery": { "id": "4ae0fc61-f92f-4fa6-9cd5-a8f31a2616c7", "lastUpdated": "2024-10-01T15:27:36Z" } } ], "totalResults": 24 } ```