License Plate API

License Plate API Documentation

Introduction

Overview

The EuroStocks License Plate API is an interface to provide Products based on License Plate from EuroStocks database and make them available to third parties.

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

The API is available at this base URL:

https://licenseplate-api.eurostocks.com

Main features

• List of Main Categories By License Plate

• List of Sub Categories By License Plate

• List of Product Types By License Plate

• Search Products By License Plate

Prerequisites

License Plate API access can be granted to suppliers who wants to search Products by License Plate on EuroStocks 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-licenseplate-api.eurostocks.com.

List of Main Categories By License Plate

POST https://services.eurostocks.com/api/v1/licenseplatesearch/mainCategories

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
LicensePlate*	String	Search by LicensePlate. Mandatory Parameter.
LanguageIsoCode	String	Search by languages using LanguageIsoCode. Mandatory Parameter.

200: OK

{
    // Response
}

Sample Success Request

POST /api/v1/licenseplatesearch/mainCategories
HOST: licenseplate-api.eurostocks.com

{
  "LicensePlate": "k689lz",
  "LanguageIsoCode": "nl"
}

Sample Success Response

HTTP/1.1 200

[
  {
    "Name": "Auto onderdelen",
    "Key": "CAR_PARTS",
    "ImageUrl": "https://images.automotivecdn.com/common/categories/main/light/car_parts_1623743434963.png",
    "TotalAssets": 267
  }
]

Sample Error Request

POST /api/v1/licenseplatesearch/mainCategories
HOST: licenseplate-api.eurostocks.com


{
  "LicensePlate": "k68*9lz",
  "LanguageIsoCode": "nl"
}

Sample Error Response

HTTP/1.1 400 Bad Request

{
  "Code": "BadRequest",
  "Message": "'k68*9lz' - License Plate must be alphanumeric "
}

List of Sub Categories By License Plate

POST https://services.eurostocks.com/api/v1/licenseplatesearch/subCategories

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
MainCategory*	String	Search by Main Category of Products. Mandatory Parameter.
LicensePlate	String	Search by LicensePlate. Mandatory Parameter.
LanguageIsoCode	String	Search by languages using LanguageIsoCode. Mandatory Parameter.

200: OK

{
    // Response
}

Sample Success Request

POST /api/v1/licenseplatesearch/subCategories
HOST: licenseplate-api.eurostocks.com

{
  "MainCategory": "CAR_PARTS",
  "LicensePlate": "k689lz",
  "LanguageIsoCode": "nl"
}

Sample Success Response

HTTP/1.1 200

[
  {
    "Name": "Airbags en toebehoren",
    "Key": "AIRBAGS_AND_ACCESSORIES",
    "ImageUrl": "https://images.automotivecdn.com/common/categories/sub/light/common.png",
    "TotalAssets": 135
  },
  {
    "Name": "Bumpers, grille en toebehoren",
    "Key": "BUMPERS_GRILLE_AND_ACCESSORIES",
    "ImageUrl": "https://images.automotivecdn.com/common/categories/sub/light/common.png",
    "TotalAssets": 51
  },
  {
    "Name": "Koelsysteem",
    "Key": "COOLING_SYSTEM",
    "ImageUrl": "https://images.automotivecdn.com/common/categories/sub/light/common.png",
    "TotalAssets": 30
  },
  ...
]

Sample Error Request

POST /api/v1/licenseplatesearch/subCategories
HOST: licenseplate-api.eurostocks.com


{
  "MainCategory": "",
  "LicensePlate": "k689lz",
  "LanguageIsoCode": "nl"
}

Sample Error Response

HTTP/1.1 400 Bad Request

{
  "Code": "BadRequest",
  "Message": "MainCategory is missing"
}

List of Product Types By License Plate

POST https://services.eurostocks.com/api/v1/licenseplatesearch/productTypes

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
MainCategory*	String	Search by Main Category of Products. Mandatory Parameter.
SubCategory	String	Search by Sub Category of Products. Mandatory Parameter.
LicensePlate	String	Search by LicensePlate. Mandatory Parameter.
LanguageIsoCode	String	Search by languages using LanguageIsoCode. Mandatory Parameter.

200: OK

{
    // Response
}

Sample Success Request

POST /api/v1/licenseplatesearch/productTypes
HOST: licenseplate-api.eurostocks.com

{
  "MainCategory": "CAR_PARTS",
  "SubCategory": "AIRBAGS_AND_ACCESSORIES",
  "LicensePlate": "k689lz",
  "LanguageIsoCode": "nl"
}

Sample Success Response

HTTP/1.1 200

[
  {
    "Name": "Stuur airbag",
    "Key": "SEND_AIRBAG",
    "ImageUrl": "https://images.automotivecdn.com/common/categories/type/light/common.png",
    "TotalAssets": 38
  },
  {
    "Name": "Hemel airbag",
    "Key": "SKY_AIRBAG",
    "ImageUrl": "https://images.automotivecdn.com/common/categories/type/light/common.png",
    "TotalAssets": 37
  },
  {
    "Name": "Gordelspanner",
    "Key": "BELT_TENSIONER",
    "ImageUrl": "https://images.automotivecdn.com/common/categories/type/light/common.png",
    "TotalAssets": 21
  },
  ...
]

Sample Error Request

POST /api/v1/licenseplatesearch/productTypes
HOST: licenseplate-api.eurostocks.com


{
  "MainCategory": "CAR_PARTS",
  "SubCategory": "",
  "LicensePlate": "k689lz",
  "LanguageIsoCode": "nl"
}

Sample Error Response

HTTP/1.1 400 Bad Request

{
  "Code": "BadRequest",
  "Message": "SubCategory is missing"
}

Search Products By License Plate

POST https://services.eurostocks.com/api/v1/licenseplatesearch/list

Headers

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

Request Body

Name	Type	Description
PageNumber	String	No. of the page for which we want details. Mandatory Parameter.
LanguageIsoCode	String	Search by languages using LanguageIsoCode. Mandatory Parameter.
PageSize	String	PageSize is no. of records on single page. Minimun PageSize is 1 and Maximum PageSize is 24. Mandatory Parameter.
SortOn	String	SortOn is used to get result based on different sorting options. Click to read details about SortOn options. Mandatory Parameter.
MainCategory	String	Search by Main Category of Products. Optional Parameter.
ResultType	String	Use ResultType_Product for search Products. Mandatory Parameter.
SortOrder	String	Sorting can be in 'desc' or 'asc' order. Mandatory Parameter.
Type	String	Search by Type of Products. Optional Parameter.
LicensePlate	String	Search by LicensePlate. Mandatory Parameter.
SubCategory	String	Search by Sub Category of Products. Optional Parameter.

200: OK

{
    // Response
}

Sample Success Request

POST /api/v1/licenseplatesearch/list
HOST: licenseplate-api.eurostocks.com

{
  "MainCategory":"CAR_PARTS",
  "SubCategory":"BUMPERS_GRILLE_AND_ACCESSORIES",
  "Type":"FRONT_BUMPER",
  "LicensePlate":"k689lz",
  "LanguageIsoCode":"nl",
  "ResultType":"ResultType_Product",
  "PageNumber":1,
  "PageSize":10,
  "SortOn":"SortBy_Id",
  "SortOrder":"desc"
}

Sample Success Response

HTTP/1.1 200
{
  "TotalResults": 39,
  "TotalPages": 4,
  "Results": [
    {
      "Id": 616381,
      "EurostockId": 1542848,
      "Maincategory": "CAR_PARTS",
      "Subcagegory": "BUMPERS_GRILLE_AND_ACCESSORIES",
      "Type": "FRONT_BUMPER",
      "Title": "Bumper Volkswagen Golf 7 7.5 FACELIFT R-LINE RLINE Voorbumper Compleet 1-P2-3660",
      "Price": 719.95,
      "DiscountedPrice": null,
      "LocationName": "Renoir Parts B.V.",
      "City": "Hoogvliet Rotterdam",
      "PriceOnRequest": false,
      "IsReserved": false,
      "Delivery": "Ophalen of verzenden",
      "IsUnlimitedStock": false,
      "Stock": 1,
      "KeepActiveEvenOutOfStock": false,
      "FirstRegistration": "",
      "Mileage": null,
      "Power": null,
      "OperatingHours": null,
      "PartNumber": "",
      "Condition": "Gebruikt",
      "Fuel": "",
      "GearBox": "",
      "TyreHeight": "",
      "TyreWidth": "",
      "TyreSize": "",
      "SuitableFor": "",
      "HubDiameter": "",
      "RimWidth": "",
      "EtValue": "",
      "PitchSize": "",
      "Image": "https://images.automotivecdn.com/0/b558d4b39b214812/webshop/products/616381/xxlarge/bumper-volkswagen-golf-7-7-5-facelift-r-line-rline-voorbumper-compleet-1-p2-3660-2.jpg",
      "InternalNumber": "",
      "WarehouseLocation": ""
    },
    {
      "Id": 616379,
      "EurostockId": 1542846,
      "Maincategory": "CAR_PARTS",
      "Subcagegory": "BUMPERS_GRILLE_AND_ACCESSORIES",
      "Type": "FRONT_BUMPER",
      "Title": "Bumper Volkswagen Golf 7 7.5 FACELIFT R-LINE RLINE Voorbumper Compleet 1-P2-3660",
      "Price": 719.95,
      "DiscountedPrice": null,
      "LocationName": "Renoir Parts B.V.",
      "City": "Hoogvliet Rotterdam",
      "PriceOnRequest": false,
      "IsReserved": false,
      "Delivery": "Ophalen of verzenden",
      "IsUnlimitedStock": false,
      "Stock": 1,
      "KeepActiveEvenOutOfStock": false,
      "FirstRegistration": "",
      "Mileage": null,
      "Power": null,
      "OperatingHours": null,
      "PartNumber": "",
      "Condition": "Gebruikt",
      "Fuel": "",
      "GearBox": "",
      "TyreHeight": "",
      "TyreWidth": "",
      "TyreSize": "",
      "SuitableFor": "",
      "HubDiameter": "",
      "RimWidth": "",
      "EtValue": "",
      "PitchSize": "",
      "Image": "https://images.automotivecdn.com/0/b558d4b39b214812/webshop/products/616379/xxlarge/bumper-volkswagen-golf-7-7-5-facelift-r-line-rline-voorbumper-compleet-1-p2-3660-2.jpg",
      "InternalNumber": "",
      "WarehouseLocation": ""
    },
    ...
  ]
}

Sample Error Request

POST /api/v1/licenseplatesearch/list
HOST: licenseplate-api.eurostocks.com

{
  "MainCategory":"CAR_PARTS",
  "SubCategory":"",
  "Type":"FRONT_BUMPER",
  "LicensePlate":"k689lz",
  "LanguageIsoCode":"nl",
  "ResultType":"ResultType_Product",
  "PageNumber":1,
  "PageSize":10,
  "SortOn":"SortBy_Id",
  "SortOrder":"desc"
}

Sample Error Response

HTTP/1.1 400 Bad Request

{
  "Code": "BadRequest",
  "Message": "Please add SubCategory while searching with Type"
}

Another Sample Error Request

POST /api/v1/licenseplatesearch/list
HOST: licenseplate-api.eurostocks.com

{
"MainCategory":"",
"SubCategory":"BUMPERS_GRILLE_AND_ACCESSORIES",
"Type":"FRONT_BUMPER",
"LicensePlate":"k689lz",
"LanguageIsoCode":"nl",
"ResultType":"ResultType_Product",
"PageNumber":1,
"PageSize":10,
"SortOn":"SortBy_Id",
"SortOrder":"desc"
}

Another Sample Error Response

HTTP/1.1 400 Bad Request

{
  "Code": "BadRequest",
  "Message": "Please add MainCategory while searching with SubCategory"
}