Vehicle Data API

Data Supplier API Documentation

Introduction

Overview

The EuroStocks Data-Supplirer-API is an interface to store vehicle to the EuroStocks-database and make them available on the platform as classified ads. It allows users to do all necessary operations like Get, Add, Update and Delete an ad information.

Documentation can be incomplete and/or outdated, Contact EuroStocks team by sending an email on [e-mail] for any questions regarding API.

The API is available at this base URL:

https://vehicles-data-api.eurostocks.com/ - New domain https://hexon.eurostocks.com - will be deprecated from 01-Jan-2021

Main features

• Create a new ad

• Update an ad

• Delete an ad

• Upload images

• Change the order of existing images

• Delete image

• Get an Ad Information

Prerequisites

Data supplier API access can be granted to suppliers who wants to send EuroStocks vehicle informations, and it required username, password and API Key to access API.

Limited support for the development process and maintenance: Please note that all examples provided in our documentation are considered as guidelines for your development process but EuroStocks for itself is not able to directly assist with any of your preferred programming languages and/or used scripts.

Test Account

A test environment can be provided. Please ask for the test account details and all the information will be used as mention in Prerequisites on test API url https://test-vehicles-data-api.eurostocks.com.

Working with Ad Data

Overview

Data Supplier API allows you to manage your vehicle inventory in a programmatic way and integrate it with other applications. It allows users to do all necessary operations like Get, Add, Update and Delete an ad information.

Generate sample request click here.

Platform Meta Data

eurostocksAdId	The unique identifier for an ad object on EuroStocks platform. Example: 123456
locationId	Reference to the company's location of this ad information. Example: 1234567
dataSupplierAdId	Unique Identification number of datasupplier. Example: 1234567
imageCount	No. of images supplier will sent for requested new vehicle

Vehicle Data

vehicleType	General vehicle types. Example: Car or Motorcycle
VehicleCategory	Different cateogies of vehicle types. Example: Sedan or Small car
make	Make of the vehicle. Example: Mercedes or Toyota
model	Model of the vehicle based on make. Example: X5 or Prius
trimline	Manufacturers identity. (OPTIONAL)
licensePlate	Vehicle identification number. (OPTIONAL)
firstRegistration	Vehicle first registration date Example:20121001 (Format: yyyyMMdd)
price	Vehicle price Price attrbiutes.
modelCode	Vehicle's model code.

Additional Ad Information

make	Provides vehicle make. For example : AUDI make is default property and can be identify from flag "IsDefaultFeature". please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/features/{vehicleTypeKey}
model	Provides vehicle model. For example : A4 model is default property and can be identify from flag "IsDefaultFeature". please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/features/{vehicleTypeKey}
trimline	Provides vehicle trimline. trimline is default property and can be identify from flag "IsDefaultAttribute". please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/attributes/{vehicleTypeKey}
licensePlate	Provides vehicle licensePlate. licensePlate is default property and can be identify from flag "IsDefaultAttribute". please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/attributes/{vehicleTypeKey}
firstRegistration	Provides vehicle firstRegistration. firstRegistration is default property and can be identify from flag "IsDefaultAttribute". please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/attributes/{vehicleTypeKey}
modelCode	Provides vehicle modelCode. modelCode is default property and can be identify from flag "IsDefaultAttribute". please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/attributes/{vehicleTypeKey}
features	Provides all the feature available for selected vehicle type. For example: ABS and PARKINGASSISTANTS. PARKINGASSISTANTS is multiple value allowed feature. However, CAMERA and CAM_360_DEGREES can not be sent together.
features values	Provides all the feature values available for selected feature. For example: ABS = "YES".
attributes	Provides all the attribute available for selected vehicle type. For example: DOOR_COUNT.
vehicleInfo	Provides multilingual attributes which allows to add attribute for different languages. For example: REMARKS and ADDITIONALREMARKS. LANGUAGEISOCODE is mandatory when you want to send multilingual attributes. On Attributes response you will find flag "IsMultilingualAttribute" to identify if attribute is multilingual or not. To get multilingual attributes please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/attributes/{vehicleTypeKey} To get all supported languages : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/languages In case of mandatory multilingual attrbiutes, It is required for 'NL' only. If value is not available for other language then it is not mandatory to send for those languages.
priceInfo	Provides price information which will allow to calculate price. For example : PRICE_ON_REQUEST VAT_RECLAIMABLE is mandatory when any price fields is added. On Attributes and Features response you will find flag "IsPriceAttribute" and "IsPriceFeature" respectively to identify attribute and feature is part of price info or not. To get "IsPriceAttribute" and "IsPriceFeature" please refer API : https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/attributes/{vehicleTypeKey} and https://vehicles-data-api.eurostocks.com/api/v2/vehicledatasupplier/features/{vehicleTypeKey}.

How Ad Data Are Rendered

Representation as JSON data in Supplier API

This is an ad fragment in JSON format for demonstration purposes only, some fields are not included.

{  
   "eurostocksAdId":null,
   "locationId": 1,
   "dataSupplierAdId": 123456,
   "imageCount": 2,
   "vehicleType":"AUTOS",
   "vehicleCategory":"ESTATE_CAR",
   "make":"VW",
   "model":"GOLF_SPORTSVAN",
   "trimline":"Trendline",
   "licensePlate":"79XXBH",
   "firstRegistrationDate":"20120101",   
   "priceInfo": {
   	  "VAT_RECLAIMABLE":"YES",
	  "PRICE_NL":"20000",
	  "EX_VAT_NL":"YES",
	  "EX_BPM_NL":"YES",
          "PRICE_PORTAL_NL":"15000",
	  "EX_VAT_PORTAL_NL":"NO",
	  "EX_BPM_PORTAL_NL":"NO",
	  "PRICE_PORTAL_NL_B2B":"25000",
	  "EX_VAT_PORTAL_NL_B2B":"NO",
	  "EX_BPM_PORTAL_NL_B2B":"YES",
	  "PRICE_ON_REQUEST": "YES"
   },
   "modelCode":"AM1",
   "vehicleInfo":[  
      {  
         "LANGUAGE_ISO_CODE":"nl",
		 "VARIANT":"1.6 TDI",
         "TITLE_REMARKS":"DSG | NAVI | Lichtmetaal",
         "TITLE_ADDITIONAL_REMARKS":"Iedere zondag geopend!",
         "PORTAL_DESCRIPTION":"NL Description",
         "OTHER_ATTRIBUTES":"NL OTHERATTRIBUTES",
         "OTHER_FEATURES":"NL OTHERFEATURES",
         "STANDARD_VEHICLE_DESCRIPTION":"NL Additional description",
	 "WARRANTY_DESCRIPTION":"NL WARRANTY_DESCRIPTION"
      },
      {  
         "LANGUAGE_ISO_CODE":"en",
         "TITLE_REMARKS":"EN Remark",
         "TITLE_ADDITIONAL_REMARKS":"EN Additional Remark",
         "PORTAL_DESCRIPTION":"EN Description",
         "OTHER_ATTRIBUTES":"EN OTHERATTRIBUTES",
         "OTHER_FEATURES":"EN OTHERFEATURES",
         "STANDARD_VEHICLE_DESCRIPTION":"EN Additional description"		 
      },
      {  
         "LANGUAGE_ISO_CODE":"de",
         "TITLE_REMARKS":"DE Remark",
         "TITLE_ADDITIONAL_REMARKS":"DE Additional Remark",
         "PORTAL_DESCRIPTION":"DE Description",
         "OTHER_ATTRIBUTES":"DE : OTHERATTRIBUTES",
         "OTHER_FEATURES":"DE OTHERFEATURES",
         "STANDARD_VEHICLE_DESCRIPTION":"DE Additional description",
	 "WARRANTY_DESCRIPTION":"DE WARRANTY_DESCRIPTION"
      }
   ],
   "features":{  
      "USB":"YES",
      "TOUCH_SCREEN":"YES",      
	  "PARKINGASSISTANTS": [
		"CAM_360_DEGREES",
		"AUTOMATIC_PARKING"
	  ],
	  "VOICE_CONTROL":"YES"
   },
   "attributes":{  
      "AXLES":"1",
      "MILEAGE":"400000"
   }
}

Create a new ad

Create a new ad

POST https://services.eurostocks.com/api/v2/vehicledatasupplier/vehicledetails

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Data Types

Request	Success Response
Ad	n/a

Sample Success Request

HOST: vehicles-data-api.eurostocks.com

{  
   "eurostocksAdId":null,
   "locationId": 1,
   "dataSupplierAdId": 123456,
   "imageCount": 2,
   "vehicleType":"AUTOS",
   "vehicleCategory":"ESTATE",
   "make":"FORD",
   "model": "FOCUS",
   "trimline":"Trendline",
   "licensePlate": "79XXBH",
   "firstRegistrationDate":"20150113",
   "priceInfo": {
   	  "VAT_RECLAIMABLE":"YES",
           "PRICE_NL":"13000",
	  "EX_VAT_NL":"NO",
	  "EX_BPM_NL":"NO",
          "PRICE_EXPORT":"10000",
	  "EX_VAT_EXPORT":"YES",
	  "EX_BPM_EXPORT":"YES",
	  "PRICE_ON_REQUEST": "YES"
	},
   "modelCode":"AM1",
   "vehicleInfo":[  
      {  
         "LANGUAGE_ISO_CODE":"nl",
		  "VARIANT":"1.6 TDI",
          "TITLE_REMARKS":"NL Remark AC Seats",
          "TITLE_ADDITIONAL_REMARKS":"NL Additional Remark",
           "OTHER_ATTRIBUTES":"nl : OTHERATTRIBUTES",
          "OTHER_FEATURES":"16 felgen, Aansluiting Aux, Achterbank neerklapbaar (ongelijke delen), Afstandsbediening Centrale Deurvergrendeling, Airbag(s) front + zij, Audiobediening op het stuurwiel, Bagage afdekking, Buitenspiegels in carrosseriekleur, Buitenspiegels met instapverlichting, Climate control (L/R gescheiden), El. bedienbare ramen achter, El. bedienbare ramen voor, El. inklapbare buitenspiegels, Elektrisch bedienbare ramen achter, Elektrisch bedienbare ramen voor, Euro 6d, Halogeen koplampen, hoofdsteunen achter, Krik, LED achterlichten, Middenarmsteun voor, Rijbaanassistentie, Ruitenwisser achter, WiFi ",
"WARRANTY_DESCRIPTION":"NL WARRANTY_DESCRIPTION",
"VEHICLE_SPECIFIC_DESCRIPTION": "NL VEHICLE_SPECIFIC_DESCRIPTION",
"STANDARD_VEHICLE_DESCRIPTION":"NL STANDARD_VEHICLE_DESCRIPTION"
      },
      {  
         "LANGUAGE_ISO_CODE":"de",
         "TITLE_ADDITIONAL_REMARKS":"DE Air Condition",
         "OTHER_ATTRIBUTES":"de : OTHERATTRIBUTES",
"WARRANTY_DESCRIPTION":"DE WARRANTY_DESCRIPTION",
"VEHICLE_SPECIFIC_DESCRIPTION": "DE VEHICLE_SPECIFIC_DESCRIPTION",
"STANDARD_VEHICLE_DESCRIPTION":"DE STANDARD_VEHICLE_DESCRIPTION"
      },
      {  
         "LANGUAGE_ISO_CODE":"en",
          "TITLE_ADDITIONAL_REMARKS":"EN AC",
         "OTHER_ATTRIBUTES":"DE : OTHERATTRIBUTES",
"VEHICLE_SPECIFIC_DESCRIPTION": "EN VEHICLE_SPECIFIC_DESCRIPTION",
"STANDARD_VEHICLE_DESCRIPTION":"EN STANDARD_VEHICLE_DESCRIPTION"
      }
   ],
   "features":{  
      "USB":"YES",

      "PARKINGASSISTANTS":[  
         "CAM_360_DEGREES",
         "AUTOMATIC_PARKING"
      ],

      "FUEL":"DIESEL",
     "GEARBOX":"MANUAL_GEAR",
     "DAMAGE_UNREPAIRED":"NO",
"EXTERIOR_COLOR" :"YELLOW",
"CONDITION_VEHICLES":"USED"
  
    },
   "attributes":{  
      "MILEAGE":"1000",
        "POWER":"71",
      "HIGHLIGHTS_1": "test Highlight1"

     }
}

Example Screen

Sample Success Response

HTTP/1.1 201 Created
{
    "eurostocksAdId": 71,
    "eurostocksUrl": "https://www.autospulletjes.nl/nl/vehicle/71/ford-focus-16-tdi-trendline-nl-remark-ac-seats-nl-additional-remark"   
}
Sample Error Request
POST /api/v2/vehicledatasupplier/vehicledetails/
HOST: vehicles-data-api.eurostocks.com


{  
   "eurostocksAdId":null,
   "locationId": 1,
   "dataSupplierAdId": 123456,
   "vehicleType":"AUTOS",
   "vehicleCategory":"ESTATE_CAR",
  "make":"VW",
   "model":"GOLF_SPORTSVAN",
   "trimline":"Trendline",
   "licensePlate":"79XXBH",
   "firstRegistrationDate":"20120101",
   "priceInfo": {
   	  "VAT_RECLAIMABLE":"YES",
	  "PRICE_NL":"20000",
	  "EX_VAT_NL":"YES",
	  "EX_BPM_NL":"YES",
          "PRICE_PORTAL_NL":"15000",
	  "EX_VAT_PORTAL_NL":"NO",
	  "EX_BPM_PORTAL_NL":"NO",
	  "PRICE_PORTAL_NL_B2B":"25000",
	  "EX_VAT_PORTAL_NL_B2B":"NO",
	  "EX_BPM_PORTAL_NL_B2B":"YES",
	  "PRICE_ON_REQUEST": "YES"
   },
   "modelCode":"AM1",
   "vehicleInfo":[  
      {  
         "LANGUAGE_ISO_CODE":"nl",
		 "VARIANT":"1.6 TDI",
         "TITLE_REMARKS":"NL Remark",
         "TITLE_ADDITIONAL_REMARKS":"NL Additional Remark",
         "PORTAL_DESCRIPTION":"NL Description",
         "OTHER_ATTRIBUTES":"NL OTHERATTRIBUTES",
         "STANDARD_VEHICLE_DESCRIPTION":"NL Additional description"
      },
      {  
         "LANGUAGE_ISO_CODE":"en",
         "TITLE_REMARKS":"EN Remark",
         "TITLE_ADDITIONAL_REMARKS":"EN Additional Remark",
         "PORTAL_DESCRIPTION":"EN Description",
         "OTHER_ATTRIBUTES":"EN OTHERATTRIBUTES",
         "STANDARD_VEHICLE_DESCRIPTION":"EN Additional description"
      },
      {  
         "LANGUAGE_ISO_CODE":"de",
         "TITLE_REMARKS":"DE Remark",
         "TITLE_ADDITIONAL_REMARKS":"DE Additional Remark",
         "PORTAL_DESCRIPTION":"DE Description",
         "OTHER_ATTRIBUTES":"DE : OTHERATTRIBUTES",
         "STANDARD_VEHICLE_DESCRIPTION":"DE Additional description"
      }
   ],
   "features":{  
      "USB":"YES",
      "TOUCH_SCREEN":"YES",
      "VOICE_CONTROL":"YES"
   },
   "attributes":{  
      "AXLES":"1",
      "MILEAGE":"400000"
   }
}

Sample Error Response

HTTP/1.1 400 Bad Request

{
    "Code": "Invalid",
    "Message": "20121301 is invalid value of attribute FIRSTREGISTRATION"
}

Update an ad

PUT https://services.eurostocks.com/api/v2/vehicledatasupplier/vehicledetails

Headers

Name	Type	Description
UserName	String	Username which EuroStocks provides
Password	String	Password which EuroStocks provides
APIKey	String	ApiKey which EuroStocks provides

200: OK

{
    // Response
}

Data Types

Request	Success Response
Ad	n/a

Sample Success Request

PUT /api/v2/vehicledatasupplier/vehicledetails/
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

{  
   "eurostocksAdId": 211925,
   "locationId": 1,
   "dataSupplierAdId": 12345,
   "vehicleType":"AUTOS",
   "vehicleCategory":"ESTATE_CAR",
   "make":"VW",
   "model":"GOLF_SPORTSVAN",
   "trimline":"Trendline",
   "licensePlate":"79XXBH",
   "firstRegistrationDate":"20120101",
   "priceInfo": {
   	  "VAT_RECLAIMABLE":"YES",
	  "PRICE_NL":"20000",
	  "EX_VAT_NL":"YES",
	  "EX_BPM_NL":"YES",
	  "PRICE_PORTAL_NL":"15000",
	  "EX_VAT_PORTAL_NL":"NO",
	  "EX_BPM_PORTAL_NL":"NO",
	  "PRICE_PORTAL_NL_B2B":"25000",
	  "EX_VAT_PORTAL_NL_B2B":"NO",
	  "EX_BPM_PORTAL_NL_B2B":"YES",
	  "PRICE_ON_REQUEST": "YES"
   },
   "modelCode":"AM1",
   "vehicleInfo":[  
      {  
         "LANGUAGE_ISO_CODE":"nl",
		 "VARIANT":"1.6 TDI",
         "TITLE_REMARKS":"NL Remark",
         "TITLE_ADDITIONAL_REMARKS":"NL Additional Remark",
         "PORTAL_DESCRIPTION":"NL Description",
         "OTHER_ATTRIBUTES":"NL OTHERATTRIBUTES",
         "STANDARD_VEHICLE_DESCRIPTION":"NL Additional description"
      },
      {  
         "LANGUAGE_ISO_CODE":"en",
         "TITLE_REMARKS":"EN Remark",
         "TITLE_ADDITIONAL_REMARKS":"EN Additional Remark",
         "PORTAL_DESCRIPTION":"EN Description",
         "OTHER_ATTRIBUTES":"EN OTHERATTRIBUTES",
         "STANDARD_VEHICLE_DESCRIPTION":"EN Additional description"
      },
      {  
         "LANGUAGE_ISO_CODE":"de",
         "TITLE_REMARKS":"DE Remark",
         "TITLE_ADDITIONAL_REMARKS":"DE Additional Remark",
         "PORTAL_DESCRIPTION":"DE Description",
         "OTHER_ATTRIBUTES":"DE : OTHERATTRIBUTES",
         "STANDARD_VEHICLE_DESCRIPTION":"DE Additional description"
      }
   ],
   "features":{  
      "USB":"YES",
      "TOUCH_SCREEN":"YES",
      "VOICE_CONTROL":"YES"
   },
   "attributes":{  
      "AXLES":"1",
      "MILEAGE":"400000"
   }
}

Sample Success Response

HTTP/1.1 200 OK
					
{
    "eurostocksAdId": 211925,
    "eurostocksUrl": "https://www.autospulletjes.nl/nl/vehicle/211925/ford-focus-16-tdi-trendline-nl-remark-ac-seats-nl-additional-remark"   
}

Delete an ad

DELETE https://services.eurostocks.com/api/v2/vehicledatasupplier/{locationId}/{eurostocksAdId}

No need to delete images before deleting vehicle.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId*	Number	Unique Identification number of vehicle you want to delete

200: OK

{
    // Response
}

Sample Success Request

DELETE /api/v2/vehicledatasupplier/{locationId}/{eurostocksAdId}
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK

Upload an image

POST https://services.eurostocks.com/api/v2/vehicledatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}

Upload new image by binary data.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId	Number	Unique Identification number of vehicle you want to delete
displaySequence	Number	Sequence no. of the new image to show on the EuroStocks website

200: OK

{
    // Response
}

Data Types

Request	Success Response
binary image data	Image details in binary format

Sample Success Request

POST /api/v2/vehicledatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: vehicles-data-api.eurostocks.com

images = "binary image data"

Sample Success Response

HTTP/1.1 201 Created
					
{
    "images": [
        {
            "ref": "https://images.autospulletjes.nl/1/93d16af95549c646/webshop/vehicles/211925/xlarge/volkswagen-golf-211925-aber2fga.jpg"
        }
    ]
}

Replace existing image with new image.

Update existing image

PATCH https://services.eurostocks.com/api/v2/vehicledatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}

Replace existing image with new image.

Headers

Name	Type	Description
UserName	String	Username which EuroStocks provides
Password	String	Password which EuroStocks provides
APIKey	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId*	Number	Unique Identification number of vehicle you want to replace image
displaySequence	Number	Sequence no. of the new image want to patch

200: OK

{
    // Response
}

Data Types

Request	Success Response
binary image data	Image details in binary format

Sample Success Request

PATCH /api/v2/vehicledatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: vehicles-data-api.eurostocks.com
files = "binary image data"

Sample Success Response

HTTP/1.1 200 OK	
                      					
{
  "images": [
      {
          "ref": "https://images.autospulletjes.nl/1/93d16af95549c646/webshop/vehicles/211925/xlarge/volkswagen-golf-211925-fgr12fga.jpg"
      }
  ]
}

Change the order of existing images

Change the order of existing images

PUT https://services.eurostocks.com /api/v2/vehicledatasupplier/images/{locationId}/{eurostocksAdId}

Sequence will be set as per provided in the request.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId	Number	Unique Identification number of vehicle

200: OK

{
    // Response
}

Sample Success Request

PUT /api/v2/vehicledatasupplier/images/{locationId}/{eurostocksAdId}
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

{
    "images": [
        {
            "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/211925/xlarge/volkswagen-golf-211925-3.jpg",
			"displaySequence":2
        },
		{
            "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/211925/xlarge/volkswagen-golf-211925-1.jpg",
			"displaySequence":3
        },
		{
            "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/211925/xlarge/volkswagen-golf-211925-2.jpg",
			"displaySequence":1
        }
    ]
}

Sample Success Response

HTTP/1.1 200 OK

Delete images

DELETE https://services.eurostocks.com/api/v2/vehicledatasupplier/image/{locationId}/{eurostocksAdId}/{displaySequence}

Delete image from the Ad using eurostocksAdId.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKe*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId*	Number	Unique Identification number of vehicle
displaySequence	Number	Sequence no. of the image you want to delete

200: OK

{
    // Response
}

Sample Success Request

DELETE /api/v2/vehicledatasupplier/image/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: vehicles-data-api.eurostocks.com

Sample Success Response

HTTP/1.1 200 OK

Upload interior 360d images

POST https://services.eurostocks.com/api/v2/vehicledatasupplier/interior360dimages/{locationId}/{eurostocksAdId}/{displaySequence}

Upload new 360d image by binary data..

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId*	Number	Unique Identification number of vehicle you want to replace image
displaySequence	Number	Sequence no. of the new image

200: OK

{
    // Response
}

Data Types

Request	Success Response
fileName	Name of the image to update
binary image data	Image details in binary format

Sample Success Request

POST /api/v2/vehicledatasupplier/interior360dimages/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: vehicles-data-api.eurostocks.com
interiorimages = "binary image data"

Sample Success Response

HTTP/1.1 201 Created
					
{
    "images": [
        {
            "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/129849/360d/interior/Volkswagen-Golf-1.jpg"
        }
    ]
}	

Update 360d existing image

PATCH https://services.eurostocks.com/api/v2/vehicledatasupplier/interior360dimages/{locationId}/{eurostocksAdId}

Replace existing image with new image.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId	Number	Unique Identification number of vehicle you want to replace image

200: OK

{
    // Response
}

Data Types

Request	Success Response
fileName	Name of the image to update
binary image data	Image details in binary format

Sample Success Request

PATCH /api/v2/vehicledatasupplier/interior360dimages/{locationId}/{eurostocksAdId}
HOST: vehicles-data-api.eurostocks.com
fileName = "Accord-124Spider-1245678-1.JPG"
interiorimages = "binary image data"

Sample Success Response

HTTP/1.1 200 OK	

Change the order of existing interior 360d images

PUT https://services.eurostocks.com/api/v2/vehicledatasupplier/interior360dimages/{locationId}/{eurostocksAdId}

Sequence will be set as per provided in the request.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId	String	Unique Identification number of vehicle

Sample Success Request

PUT /api/v2/vehicledatasupplier/interior360dimages/{locationId}/{EuroStocksAdId}
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"
{
 "Images": [
        {
		   "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/129849/360d/interior/Volkswagen-Golf-1.jpg",
		   "displaySequence":2
        },
		{
		   "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/129849/360d/interior/Volkswagen-Golf-2.jpg",
		   "displaySequence":1
        }
    ]
}

Sample Success Response

HTTP/1.1 200 OK

Delete 360d interior image

DELETE https://services.eurostocks.com/api/v2/vehicledatasupplier/interior360dimages/{locationId}/{eurostocksAdId}/{displaySequence}

Delete image from the Ad using eurostocksAdId.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId*	Number	Unique Identification number of vehicle
displaySequence	Number	Sequence no. of the image you want to delete

200: OK

{
    // Response
}

Sample Success Request

DELETE /api/v2/vehicledatasupplier/interior360dimages/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: vehicles-data-api.eurostocks.com

Sample Success Response

HTTP/1.1 200 OK

Get an Ad Information

GET https://services.eurostocks.com

Get detailed information about the Ad with features and attributes.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added
eurostocksAdId	Number	Unique Identification number of vehicle

Sample Success Request

GET /api/v2/vehicledatasupplier/vehicleDetails/{locationId}/{eurostocksAdId}
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                                
{
  "eurostocksAdId": 1245678,
  "locationId": 1,
  "vehicleType": "AUTOS",
  "vehicleCategory": "ESTATE_CAR",
  "make": "VW",
  "model": "GOLF_SPORTSVAN",
  "trimline": "Trendline",
  "licensePlate": "79XXBH",
  "firstRegistrationDate": "20120101",
  "priceInfo": {
        "grossPrice": "14399",
        "netPrice": "11900",
        "vat": "2499"
  },
  "modelCode": "AM1",
  "vehicleInfo":[  
      {  
         "LANGUAGE_ISO_CODE": "nl",
		 "VARIANT":"1.6 TDI",
         "TITLE_REMARKS": "DSG | NAVI | Lichtmetaal",
         "TITLE_ADDITIONAL_REMARKS": "Iedere zondag geopend!",
         "PORTAL_DESCRIPTION": "NL Description",
         "OTHER_ATTRIBUTES": "NL OTHERATTRIBUTES",
         "STANDARD_VEHICLE_DESCRIPTION": "NL Additional description"
      },
    {
      "LANGUAGE_ISO_CODE": "de",
	  "VARIANT":"1.6 TDI",
      "TITLE_REMARKS": "DE Remark",
      "TITLE_ADDITIONAL_REMARKS": "DE Additional Remark",
      "STANDARD_VEHICLE_DESCRIPTION": "DE Additional description",
      "OTHER_ATTRIBUTES": "DE : OTHERATTRIBUTES",
      "PORTAL_DESCRIPTION": "DE Description"
    },
    {
      "LANGUAGE_ISO_CODE": "en",
	  "VARIANT":"1.6 TDI",
      "TITLE_REMARKS": "EN Remark",
      "TITLE_ADDITIONAL_REMARKS": "NL Additional Remark",
      "STANDARD_VEHICLE_DESCRIPTION": "EN Additional description",
      "OTHER_ATTRIBUTES": "EN : OTHERATTRIBUTES",
      "PORTAL_DESCRIPTION": "EN Description"
    }    
  ],
  "features": {
    "USB": "YES",
    "TOUCH_SCREEN": "YES",
    "VOICE_CONTROL": "YES"
  },
  "attributes": {
    "AXLES": "1",
    "MILEAGE": "400000"
  },
  "Images": [
        {
		  "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/211925/xlarge/volkswagen-golf-211925-2.jpg",
		  "displaySequence": 1
        },
		{
		  "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/211925/xlarge/volkswagen-golf-211925-3.jpg",
		  "displaySequence": 2

        }
    ],
	"interiorimages": [
        {
		   "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/129849/360d/interior/Volkswagen-Golf-1.jpg"
        },
		{
		   "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/vehicles/129849/360d/interior/Volkswagen-Golf-1.jpg"
        }
    ]
}

Get Location Information

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/locations

Get all the locations details associated with supplier.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

200: OK

{
    // Response
}

Sample Success Request

GET /api/v2/vehicledatasupplier/locations
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
[
  {
    "locationId": 1,
    "locationName": "Autospulletjes",
    "postCode": "1054WS",
    "street": "Wilhelminastraat",
    "houseNumber": 162,
    "houseNumberExtension": "hs",
    "city": "Amsterdam"
  }
  ....
]

Get an Ad Information From Location

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/vehicleDetails/{locationId}/

Get all vehicles added for specific location and location must be associated with supplier.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
locationId*	Number	Unique Identification number of location for which vehicle is added

200: OK

{
    // Response
}

Sample Success Request

GET /api/v2/vehicledatasupplier/vehicleDetails/{locationId}
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                                
[
  {
    "eurostocksAdId": 1519,
    "locationId": 1,
    "vehicleType": "AUTOS",
    "vehicleCategory": "ESTATE_CAR",
    "make": "AUDI",
    "model": "A3",
    "trimline": "Trendline",
    "modelCode": "AM1",
    "licensePlate": "79XXBH",
    "firstRegistrationDate": "20060113"
  },  
....
]

Vehicle Types

GET https://services.eurostocks.comapi/v1/vehicledatasupplier/vehicletypes

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Sample Success Request

GET /api/v2/vehicledatasupplier/vehicletypes
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK

[
  {
    "Key": "AUTOS",
    "Description": "Auto's"
  },
  {
    "Key": "AGRICULTURAL_VEHICLE",
    "Description": "Landbouwvoertuigen"
  },
  {
    "Key": "BUSSES",
    "Description": "Bussen"
  },
  {
    "Key": "CONSTRUCTION_MACHINES",
    "Description": "Bouwmachines"
  },
  ....
]

Vehicle Category

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/vehiclecategories/{vehicleTypeKey}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
vehicleTypeKey*	String	Vehicle type key to get it's categories

Sample Success Request

GET /api/v2/vehicledatasupplier/vehiclecategories/AUTOS
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK

[
  {
    "Key": "CONVERTIBLE_ROADSTER",
    "Description": "Cabriolet | Roadster"
  },
  {
    "Key": "COUPE",
    "Description": "Coupé"
  },
  {
    "Key": "ESTATE",
    "Description": "Stationwagen"
  },
  {
    "Key": "OTHER",
    "Description": "Overige"
  },
  {
    "Key": "SALOON",
    "Description": "Sedan"
  },
  ...
]

Makes

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/makes/{vehicleTypeKey}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
vehicleTypeKey*	String	Vehicle type key to get it's makes

Sample Success Request

GET /api/v2/vehicledatasupplier/makes/AUTOS
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
[
   {
    "Key": "ABARTH",
    "Description": "Abarth"
  },
  {
    "Key": "ABG",
    "Description": "ABG"
  },
  {
    "Key": "ABI",
    "Description": "ABI"
  },
  {
    "Key": "AC",
    "Description": "AC"
  },
  {
    "Key": "ACCESS_MOTOR",
    "Description": "Access Motor"
  },
  ...
]

Models

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/models/{vehicleTypeKey}/{makeKey}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
vehicleTypeKey*	String	Vehicle type key to get it's model based on selected make
makeKey*	String	Make key to get related models

Sample Success Request

GET /api/v2/vehicledatasupplier/models/AUTOS/ABARTH
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
						
[
  {
    "Key": "124_SPIDER",
    "Description": "124 Spider"
  },
  {
    "Key": "500",
    "Description": "500"
  },
  {
    "Key": "500C",
    "Description": "500C"
  },
  {
    "Key": "595",
    "Description": "595"
  },
  {
    "Key": "595_COMPETIZIONE",
    "Description": "595 Competizione"
  },
  {
    "Key": "595_TURISMO",
    "Description": "595 Turismo"
  },
  ...
]

Features

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/features/{vehicleTypeKey}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
vehicleTypeKey*	String	Vehicle type key to get features

200: OK

{
    // Response
}

Sample Success Request

GET /api/v2/vehicledatasupplier/features/AUTOS
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
						
[
  {
    "Key": "ABS",
	"Description": "ABS",
    "IsMandatory": false,
    "IsMultipleAllowed": false,
    "IsPriceFeature": false,
    "IsDefaultFeature": false
  },
  {
    "Key": "ACCIDENT_DAMAGED",
	"Description": "Schade verleden",
    "IsMandatory": false,
    "IsMultipleAllowed": false,
    "IsPriceFeature": false,
    "IsDefaultFeature": false
  },
  {
    "Key": "AIR_SUSPENSION",
	"Description": "Luchtvering",
    "IsMandatory": false,
    "IsMultipleAllowed": false,
    "IsPriceFeature": false,
    "IsDefaultFeature": false
  }, 
  ...
  {
    "Key": "PARKINGASSISTANTS",
	"Description": "Parkeersensoren",
    "IsMandatory": false,
    "IsMultipleAllowed": true,
	"IsPriceFeature": false,
    "IsDefaultFeature": false
  },
  ...
]

Feature Values

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/featurevalues/{featureKey}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
featureKey*	String	Feature key to get it's values

200: OK

{
    // Response
}

Sample Success Request

GET /api/v2/vehicledatasupplier/featurevalues/PARKINGASSISTANTS
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
[
  {
    "Key": "CAM_360_DEGREES",
	"Description": "360° camera"
  },
  {
    "Key": "AUTOMATIC_PARKING",
	"Description": "Zelfsturend systeem | Parking Assistent"
  },
  {
    "Key": "CAMERA",
	"Description": "Camera"
  },
  {
    "Key": "ACHTER",
	"Description": "Achter"
  },
  {
    "Key": "VOOR",
	"Description": "Voor"
  }
]

Attributes

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/attributes/{vehicleTypeKey}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
vehicleTypeKey*	String	Vehicle type key to get attributes

200: OK

{
    // Response
}

Sample Success Request

GET /api/v2/vehicledatasupplier/attributes/AUTOS
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
[
  {
    "Key": "TITLE_ADDITIONAL_REMARKS",
	"Description": "Extra aanvullende titel omschrijving",
    "InputType": "None",
    "IsManadatory": false,
    "IsMultilingualAttribute": true,
	"IsPriceAttribute": false,
    "IsDefaultAttribute": false
  },
  {
    "Key": "AXLES",
	"Description": "Aantal assen",
    "InputType": "Number",
    "IsManadatory": false,
    "IsMultilingualAttribute": false,
	"IsPriceAttribute": false,
    "IsDefaultAttribute": false
  },
  {
    "Key": "BATTERYCAPACITY",
	"Description": "Capaciteit accu in kWh",
    "InputType": "Number",
    "IsManadatory": false,
    "IsMultilingualAttribute": false,
	"IsPriceAttribute": false,
    "IsDefaultAttribute": false
  },
  ...
]

Languages

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/languages

List of all supported languages for vehicle info.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Sample Success Request

GET /api/v2/vehicledatasupplier/languages
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
[
  {
    "Key": "de"
  },
  {
    "Key": "en"
  },
  {
    "Key": "nl"
  },
  ...
]

Sample request Body

GET https://services.eurostocks.com/api/v2/vehicledatasupplier/VehicleDataSupplierRequestTemplate/{vehicleTypeKey}/{mandatoryMode}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
vehicleTypeKey*	String	Vehicle type key to get attributes
mandatoryMode	String	mandatoryMode=true is when only want mandatory details associated with Vehicle Type in request to create new Ad mandatoryMode=false is to get all details associated with Vehicle Type to create new Ad

Sample Success Request

GET /api/v2/vehicledatasupplier/VehicleDataSupplierRequestTemplate/AUTOS/true
HOST: vehicles-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
{
  "eurostocksAdId": null,
  "locationId": 0,
  "dataSupplierAdId": 0,
  "imageCount":0,
  "vehicleType": "",
  "vehicleCategory": "",
  "make": "",
  "priceInfo": {},
  "vehicleInfo": [
    {
      "LANGUAGE_ISO_CODE": "nl"
    },
    {
      "LANGUAGE_ISO_CODE": "en"
    }
  ],
  "features": {},
  "attributes": {}
}

All Error Codes

Overview

List of possible error codes with each request.

Vehicle Add/Update vehicle request

ErrorCode - 400
{attributeValue} is invalid value of attribute {attributekey}
{attributeValue} is required
Attribute not mapped with this product type
AttributeValue already exists for {attributekey}
{attributes} are not valid attributes
{features} are not valid features
No Features mapped with this product type
{features} is not exist for this category
{featureValue} invalid for feature {featureKey}
CAMERA and CAM_360_DEGREES can not select together for feature
{attributes} are mandatory attributes
{features} are mandatory features
{featuresValue} already exist for {featureKey}
Invalid Features Value for feature {featureKey}
LANGUAGE_ISO_CODE Language is not supported
LANGUAGE_ISO_CODE is required to add multilingual attribute
{VehicleType} price can not be 0.
OTHER make not allowed
OTHER model not allowed
MILEAGE should not more then 500 for new vehicle
PRICE_ON_REQUEST is not allowed for vehicle type {vehicleType}
Extended attribute(s) is mandatory for 'nl' language

ErrorCode - 500
Something went wrong
Vehicle not added

ErrorCode - 404
sub category does not exist
product type in not match with this subcategory
location is not exists
Supplier not linked with this location
No vehicle found

Vehicle Add/Update image request

ErrorCode - 400
Invalid request
Vehicle does not belongs to the supplier
Either filename or new image not found

ErrorCode - 404
Vehicle not matched with location

ErrorCode - 500
Internal server error

Vehicle Delete request

ErrorCode - 400
Invalid request
Vehicle does not belongs to the supplier

ErrorCode - 404
Vehicle not matched with location

ErrorCode - 500
Internal server error

Get Vehicle request

ErrorCode - 400
Invalid request
Vehicle does not belongs to the supplier

ErrorCode - 404
vehicle is not found
Vehicle not matched with location

ErrorCode - 500
Internal server error

Price attributes

Parameter	Description
Parameter	Description
VAT_RECLAIMABLE	Vat Reclaimable
PRICE_NL	Price NL customer
EX_VAT_NL	EX_VAT_NL customer
EX_BPM_NL	EX_BPM_NL Customer
PRICE_EXPORT	PRICE_EXPORT Customer
EX_VAT_EXPORT	EX_VAT_EXPORT Customer
EX_BPM_EXPORT	EX_BPM_EXPORT Customer
PRICE_PORTAL_NL	PRICE_PORTAL_NL Customer
EX_VAT_PORTAL_NL	EX_VAT_PORTAL_NL Customer
EX_BPM_PORTAL_NL	EX_BPM_PORTAL_NL Customer
PRICE_PORTAL_EXPORT	PRICE_PORTAL_EXPORT Customer
EX_VAT_PORTAL_EXPORT	EX_VAT_PORTAL_EXPORT Customer
EX_BPM_PORTAL_EXPORT	EX_BPM_PORTAL_EXPORT Customer
PRICE_NL_B2B	PRICE_NL_B2B Dealer
EX_VAT_NL_B2B	EX_VAT_NL_B2B Dealer
EX_BPM_NL_B2B	EX_BPM_NL_B2B Dealer
PRICE_EXPORT_B2B	PRICE_EXPORT_B2B Dealer
EX_VAT_EXPORT_B2B	EX_VAT_EXPORT_B2B Dealer
EX_BPM_EXPORT_B2B	EX_BPM_EXPORT_B2B Dealer
PRICE_PORTAL_NL_B2B	PRICE_PORTAL_NL_B2B Dealer
EX_VAT_PORTAL_NL_B2B	EX_VAT_PORTAL_NL_B2B Dealer
EX_BPM_PORTAL_NL_B2B	EX_BPM_PORTAL_NL_B2B Dealer
PRICE_PORTAL_EXPORT_B2B	PRICE_PORTAL_EXPORT_B2B Dealer
EX_VAT_PORTAL_EXPORT_B2B	EX_VAT_PORTAL_EXPORT_B2B Dealer
EX_BPM_PORTAL_EXPORT_B2B	EX_BPM_PORTAL_EXPORT_B2B Dealer