ChannelEngine: Returns API updated

05 August 2019
ChannelEngine: Returns API updated

Please note: our returns API will be updated on the 19th of August 2019 which may impact your implementation.

We would like to inform you of an important upcoming change to our API. In order to continue providing you with the best possible service, we continuously roll out changes and expand our API endpoints. Normally these new functionalities have no effect for existing API users unless you update, however, we are now implementing a change to our returns API which may have 'breaking' implications for your current implementation of our API.

Pagination and additional filtering will be added to the following API endpoints:
- GET /v2/returns/merchant
- GET /v2/returns/channel

Once enabled, 100 items will be returned per page (similar to the current order pagination) instead of all the results a returns filter query may return. The fields indicating pagination are already present in the response. The existing createdSince query string parameter will be replaced by fromDate.

Currently, the ItemsPerPage is equal to the Count and TotalCount. A request matching 800 items will, therefore, return 800 items in the response. The new situation will use pagination, so the ItemsPerPage will be 100, the Count and TotalCount will match the number of items returned for that page and the total number of items matching the request respectively. So, to fetch all 800 items, multiple requests have to be made with a ?Page parameter.

Action to take:
Make sure that pagination is supported by the code that is fetching data from the ChannelEngine API. If you are using one of our API client libraries or plugins, please update to the latest version. These can be found here (merchant) and here (channel).

We'll enable the pagination on our end on the 19th of August 2019, so please update your client or change your API implementation before then to prevent possible issues.

Questions? Please contact us at

Previous blog posts

ChannelEngine statistics update: Marketplace KPI’s that matter

ChannelEngine statistics update: Marketplace KPI’s that matter

Reporting on the most important metrics is essential in optimizing marketplace sales. These numbers must be up to date and on point to make more informed decisions that help you to spot trends and ensure you that you are on the right track. favorite marketplace in the Netherlands favorite marketplace in the Netherlands is the most popular marketplace in the Netherlands, among 67 percent of the Dutch population search, which means that is the most popular marketplace in the Netherlands compared to other marketplaces.

Retail & Brands Festival 2019

Retail & Brands Festival 2019 is happy to announce that we are now a proud sponsor of the Retail & Brands Festival on the 12th of September 2019. The event will take place in Amersfoort and will begin at 10:00 am and finish at 17:30 with some drinks & bites and a Q&A about marketplaces.