Retrieve a list of reductions
This endpoint will return a list EAN’s that are eligible for reductions on the commission fee. By adjusting the price of your offer you ensure that you’re automatically making use of the reduction on your commission fee. The price of the offer needs to be lower or equal to the “MaximumPrice” to enable the reduction.
In order to use this endpoint you do need to add a specific Accept header to your request.
The response of this endpoint will return a unique header; Content-Disposition. This response header will return the name of the CSV file.
Example request and response
Status: 200 OK EAN,MaximumPrice,CostReduction,StartDate,EndDate 0000000000420,67,7.73,2017-05-16,2017-06-05 0000000337076,9.8,1.13,2017-05-16,2017-06-05 0000000411332,17.5,1.5,2017-05-16,2017-06-05 0000000411356,20,2.99,2017-05-16,2017-06-05 0000000591386,30.99,2.27,2017-05-16,2017-06-05 0000000821094,90,4.1,2017-05-16,2017-06-05 0000002495149,53.48,2.94,2017-05-16,2017-06-05 0000002873220,139.88,4.69,2017-05-16,2017-06-05 0000030056572,4.68,1.2,2017-05-16,2017-06-05 0000030089372,17,1.6,2017-05-16,2017-06-05 0000030093652,6.18,0.81,2017-05-16,2017-06-05 0000030093706,6.18,1.26,2017-05-16,2017-06-05 0000030093720,6.18,0.9,2017-05-16,2017-06-05 0000030093737,6.18,1.08,2017-05-16,2017-06-05 0000030093775,6.18,0.9,2017-05-16,2017-06-05 0000030093843,6.18,0.9,2017-05-16,2017-06-05 0000030093904,6.18,0.9,2017-05-16,2017-06-05 0000030093980,6.18,1.35,2017-05-16,2017-06-05 0000030094024,6.18,1.26,2017-05-16,2017-06-05
How to check if you have the latest list of reductions
The endpoint below will return a filename of the latest reductions list. The response from this endpoint can be compared to the response header that was given back from the endpoint above.
Example request, headers and response
Status: 200 OK Verlaging_Bemiddelingsbijdrage_31052017_0005.csv
To retrieve the entire list, first use GET /reductions. This will download a file that is 13Mb or more. With this file you will receive the filename in the Content-Disposition response.
Please use GET /reductions/latest to get the filename of the most recent reductions-list. Do not use the GET /reductions endpoint again unless this filename has changed.
By checking GET /reductions/latest and comparing this to your most recent download you can be certain that you are always up-to-date.