# Winkelstraat.nl Content REST API OpenAPI file: https://content.doc.winkelstraat.nl/source.yaml ## Description This is version `1.1.0` of this API documentation. Last update on Oct 15, 2026. The Winkelstraat.nl Content API lets partners (retailers and brands) deliver their product catalogue to Winkelstraat.nl and keep it up to date: product information, prices, stock and images. ## What you can do with this API * **Create and update products**: one call per size, including descriptions, prices, stock and image URLs. * **Update a single value**, such as stock or price, without sending the whole product. * **Delete products** that you no longer sell on Winkelstraat.nl. * **Upload images**, either as a URL in the product or as a file. * **Look up reference data**: categories, attributes and the allowed values of attributes such as brand, colour and size. * **See which products Winkelstraat asks you to send again** (renewal). ## When to use it Use the Content API when you want to connect your own PIM, ERP or webshop directly to Winkelstraat.nl, so that new products, price changes and stock changes reach us automatically. Typical patterns: * send a product (all its sizes) once when it is added to your range; * send stock and price changes as soon as they happen, using `PATCH /api/rest/v1/retailer/products/{code}/attribute/{attribute_code}`; * delete a size when you stop selling it on Winkelstraat.nl. ## Getting started 1. Request **staging** credentials from [partnersuccess@winkelstraat.nl](mailto:partnersuccess@winkelstraat.nl). 2. Request an access token (see **Authentication**). 3. Look up the category codes and the allowed attribute values (see **Attribute values**). 4. Send one or more test products on staging, preferably with several sizes. 5. Winkelstraat checks your test products. Once they are approved you receive **production** credentials and can go live (see **Environments and going live**). The topics below explain the concepts once. The endpoint pages then list, per endpoint, its purpose, the required and optional fields, the possible values, an example request, an example response and the possible errors. ## Servers - https://content.winkelstraat.nl: https://content.winkelstraat.nl () ## Topics ### [Environments and going live](https://content.doc.winkelstraat.nl/topic/topic-environments-and-going-live.md) ### [Authentication](https://content.doc.winkelstraat.nl/authentication.md) ### [Products, product groups and identifiers](https://content.doc.winkelstraat.nl/topic/topic-products-product-groups-and-identifiers.md) ### [Attribute values](https://content.doc.winkelstraat.nl/topic/topic-attribute-values.md) ### [Images](https://content.doc.winkelstraat.nl/topic/topic-images.md) ### [Product status: delete, disable, out of stock](https://content.doc.winkelstraat.nl/topic/topic-product-status-delete-disable-out-of-stock.md) ### [Responses and errors](https://content.doc.winkelstraat.nl/topic/topic-responses-and-errors.md) ### [Limits](https://content.doc.winkelstraat.nl/topic/topic-limits.md) ## Endpoints ### [Retailer Utilities](https://content.doc.winkelstraat.nl/group/endpoint-retailer-utilities.md) - [Get an access token](https://content.doc.winkelstraat.nl/operation/operation-post_retailer_token.md) ### [Retailer Product](https://content.doc.winkelstraat.nl/group/endpoint-retailer-product.md) - [Get a list of retailer products](https://content.doc.winkelstraat.nl/operation/operation-get_retailer_products.md) - [Create or update a retailer product](https://content.doc.winkelstraat.nl/operation/operation-post_retailer_products.md) - [Get a retailer product](https://content.doc.winkelstraat.nl/operation/operation-get_retailer_products__code_.md) - [Delete a retailer product](https://content.doc.winkelstraat.nl/operation/operation-delete_retailer_products__code_.md) - [Update or create a retailer product](https://content.doc.winkelstraat.nl/operation/operation-patch_retailer_products__code_.md) - [Update one value of a retailer product](https://content.doc.winkelstraat.nl/operation/operation-patch_retailer_products__code_attribute__attribute_code_.md) ### [Retailer Media files](https://content.doc.winkelstraat.nl/group/endpoint-retailer-media-files.md) - [Upload an image](https://content.doc.winkelstraat.nl/operation/operation-post_retailer_media_files.md) ### [Retailer Categories](https://content.doc.winkelstraat.nl/group/endpoint-retailer-categories.md) - [Get the list of category codes](https://content.doc.winkelstraat.nl/operation/operation-get_retailer_category_codes.md) ### [Retailer Attributes](https://content.doc.winkelstraat.nl/group/endpoint-retailer-attributes.md) - [Get the list of attributes](https://content.doc.winkelstraat.nl/operation/operation-get_attributes.md) ### [Retailer Attribute options](https://content.doc.winkelstraat.nl/group/endpoint-retailer-attribute-options.md) - [Get the allowed values of an attribute](https://content.doc.winkelstraat.nl/operation/operation-get_retailer_attributes__attribute_code__options.md) ### [Retailer Renew](https://content.doc.winkelstraat.nl/group/endpoint-retailer-renew.md) - [Get the products to send again](https://content.doc.winkelstraat.nl/operation/operation-get_retailer_renew_products.md) [Powered by Bump.sh](https://bump.sh)