Get a retailer product

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/{code}

Bearer

Purpose: get one of your products (one size).

{code} is the product's identifier (your SKU). A deleted product, or a product of another partner, is answered with 404.

categories contains the category you sent together with its parent categories.

Path parameters

code string Required

The product's identifier (your SKU)

Responses

200 application/json

The product
Hide response attributes Show response 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
404 application/json

Resource not found
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/{code}

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

Response examples (200)

{
  "uuid": "d437d77f-7358-4d96-b4ab-8fe400825855",
  "identifier": "TSHIRT-001-BLACK-M",
  "parent": "TSHIRT-001-BLACK",
  "enabled": true,
  "categories": [
    "master",
    "17",
    "120"
  ],
  "values": {
    "name": [
      {
        "data": "Summer top",
        "locale": "en_US"
      },
      {
        "data": "Zomer top",
        "locale": "nl_NL"
      }
    ],
    "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"
    }
  },
  "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 (404)

{
  "code": 404,
  "message": "Product \"wsnl123-TSHIRT-001-BLACK-M\" does not exist or you do not have permission to access it."
}

Response examples (404)

{
  "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"
}