Get a list of retailer products

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://content.doc.winkelstraat.nl/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Content API MCP server": {
    "url": "https://content.doc.winkelstraat.nl/mcp"
  }
}

GET /api/rest/v1/retailer/products

Bearer

Purpose: get a paginated list of your products.

The list only contains your own products, and only products that are not deleted. Each item has the same format as GET /api/rest/v1/retailer/products/{code}.

Query parameters

search string

Filter products by additional search criteria. JSON-encoded object of field filters. Example: {"ean":[{"operator":"=","value":"1234567890123"}]}. Filters on retailer and enabled are ignored: the list is always limited to your own products that are not deleted.
limit integer

Number of results per page, at most 100

Maximum value is 100. Default value is 10.
page integer

Page number

Default value is 1.
with_count boolean

Return the total number of items in the response. This makes the request slower on large catalogues.

Default value is false.
pagination_type string

Pagination method type

Default value is page.

Responses

200 application/json

A page of your products
Hide response attributes Show response attributes object
- _links object
  
  Hide _links attributes Show _links attributes object
  
  self object
  
  Hide self attribute Show self attribute object
  
  href string
  
  URI
  
  first object
  
  Hide first attribute Show first attribute object
  
  href string
  
  URI
  
  next object
  
  Hide next attribute Show next attribute object
  
  href string
  
  URI
  
  previous object
  
  Hide previous attribute Show previous attribute object
  
  href string
  
  URI
- current_page integer
  
  Current page number
- _embedded object
  
  Hide _embedded attribute Show _embedded attribute object
  
  items array[object]
  
  Hide items attributes Show items attributes object
  
  _links object
  
  Hide _links attribute Show _links attribute object
  
  self object
  
  Hide self attribute Show self attribute object
  
  href string
  
  URI
  
  uuid string
  
  Winkelstraat's unique id of the product
  
  identifier string
  
  Your SKU for this product (one size)
  
  parent string
  
  Your code for the product group
  
  enabled boolean
  
  Always true; deleted products are not returned
  
  categories array[string]
  
  The category you sent together with its parent categories
  
  values object
  
  Product values per attribute code
  
  Hide values attribute Show values attribute object
  
  * array[object] Additional properties
  
  Hide * attributes Show * attributes object
  
  data
  
  The value. A string, number, boolean, or for prices a list of {amount, currency}.
  
  locale string
  
  nl_NL or en_US for translatable text attributes, otherwise null
  
  scope string
  
  Not used; leave it out or send null
  
  created string(date-time)
  
  Date of creation
  
  updated string(date-time)
  
  Date of the last update
401 application/json

Authentication required
Hide response attributes Show response attributes object
- code integer
  
  HTTP status code
- message string
  
  Message explaining the error
403 application/json

Access forbidden
Hide response attributes Show response attributes object
- code integer
  
  HTTP status code
- message string
  
  Message explaining the error
406 application/json

Not Acceptable
Hide response attributes Show response attributes object
- code integer
  
  HTTP status code
- message string
  
  Message explaining the error
422 application/json

Unprocessable entity
Hide response attributes Show response attributes object
- code integer
  
  HTTP status code
- message string
  
  Message explaining the error

GET /api/rest/v1/retailer/products

curl \
 --request GET 'https://content.winkelstraat.nl/api/rest/v1/retailer/products' \
 --header "Authorization: $API_KEY"

Response examples (200)

{
  "_links": {
    "self": {
      "href": "/api/rest/v1/retailer/products?page=1&with_count=false&pagination_type=page&limit=10"
    },
    "first": {
      "href": "/api/rest/v1/retailer/products?page=1&with_count=false&pagination_type=page&limit=10"
    },
    "next": {
      "href": "/api/rest/v1/retailer/products?page=2&with_count=false&pagination_type=page&limit=10"
    }
  },
  "current_page": 1,
  "_embedded": {
    "items": [
      {
        "_links": {
          "self": {
            "href": "/api/rest/v1/retailer/products/TSHIRT-001-BLACK-M"
          }
        },
        "uuid": "d437d77f-7358-4d96-b4ab-8fe400825855",
        "identifier": "TSHIRT-001-BLACK-M",
        "parent": "TSHIRT-001-BLACK",
        "enabled": true,
        "categories": [
          "master",
          "17",
          "120"
        ],
        "values": {
          "manufacturer": [
            {
              "data": "guess"
            }
          ],
          "manufacturer_product_number": [
            {
              "data": "G1234"
            }
          ],
          "color": [
            {
              "data": "black"
            }
          ],
          "size": [
            {
              "data": "m"
            }
          ],
          "ean": [
            {
              "data": "8712345000028"
            }
          ],
          "price": [
            {
              "data": [
                {
                  "amount": "29.95",
                  "currency": "EUR"
                }
              ]
            }
          ],
          "quantity": [
            {
              "data": 10
            }
          ]
        },
        "created": "2025-01-01T10:00:00+01:00",
        "updated": "2025-06-15T14:30:00+02:00"
      }
    ]
  }
}

Response examples (200)

{
  "_links": {
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "previous": {
      "href": "string"
    }
  },
  "current_page": 42,
  "_embedded": {
    "items": [
      {
        "_links": {
          "self": {
            "href": "string"
          }
        },
        "uuid": "string",
        "identifier": "string",
        "parent": "string",
        "enabled": true,
        "categories": [
          "string"
        ],
        "values": {
          "additionalProperty1": [
            {
              "locale": "string",
              "scope": "string"
            }
          ],
          "additionalProperty2": [
            {
              "locale": "string",
              "scope": "string"
            }
          ]
        },
        "created": "2026-05-04T09:42:00Z",
        "updated": "2026-05-04T09:42:00Z"
      }
    ]
  }
}

Response examples (401)

{
  "code": 401,
  "message": "The access token provided is invalid."
}

Response examples (401)

{
  "code": 42,
  "message": "string"
}

Response examples (403)

{
  "code": 403,
  "message": "Access forbidden. You are not allowed to list products."
}

Response examples (403)

{
  "code": 42,
  "message": "string"
}

Response examples (406)

{
  "code": 406,
  "message": "\"xxx\" in \"Accept\" header is not valid. Only \"application/json\" is allowed."
}

Response examples (406)

{
  "code": 42,
  "message": "string"
}

Response examples (422)

{
  "code": 422,
  "message": "Invalid category code \"999999\""
}

Response examples (422)

{
  "code": 42,
  "message": "string"
}