{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bol-com/json-schema/bol-com-product-list-request-schema.json",
  "title": "ProductListRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bol-com-products-api-openapi.yml#/components/schemas/ProductListRequest",
  "type": "object",
  "properties": {
    "countryCode": {
      "type": [
        "string",
        "null"
      ],
      "description": "The country for which the products will be retrieved.",
      "default": "NL",
      "enum": [
        "NL",
        "BE",
        null
      ]
    },
    "searchTerm": {
      "maxLength": 50,
      "minLength": 1,
      "type": [
        "string",
        "null"
      ],
      "description": "The search term to get the associated products for."
    },
    "categoryId": {
      "maxLength": 11,
      "minLength": 1,
      "type": [
        "string",
        "null"
      ],
      "description": "The category to get the associated products for."
    },
    "filterRanges": {
      "maxItems": 10,
      "minItems": 0,
      "type": [
        "array",
        "null"
      ],
      "description": "The list of range filters to get associated products for.",
      "items": {
        "$ref": "#/$defs/ProductListFilterRange"
      }
    },
    "filterValues": {
      "maxItems": 10,
      "minItems": 0,
      "type": [
        "array",
        "null"
      ],
      "description": "The list of filter values in this filter.",
      "items": {
        "$ref": "#/$defs/ProductListFilterValue"
      }
    },
    "sort": {
      "type": [
        "string",
        "null"
      ],
      "description": "Determines the order of the products.",
      "enum": [
        "RELEVANCE",
        "POPULARITY",
        "PRICE_ASC",
        "PRICE_DESC",
        "RELEASE_DATE",
        "RATING",
        "WISHLIST",
        null
      ]
    },
    "page": {
      "maximum": 200,
      "minimum": 1,
      "type": "integer",
      "description": "The requested page number with a page size of 50 items.",
      "format": "int32",
      "default": 1
    }
  },
  "$defs": {
    "ProductListFilterRange": {
      "required": [
        "max",
        "min",
        "rangeId"
      ],
      "type": "object",
      "properties": {
        "rangeId": {
          "maxLength": 11,
          "minLength": 1,
          "type": "string",
          "description": "The id of the range filter the products can be found within."
        },
        "min": {
          "type": "number",
          "description": "The minimum value for the range that can be used to filter the products."
        },
        "max": {
          "type": "number",
          "description": "The maximum value for the range that can be used to filter the products."
        }
      },
      "description": "The list of range filters to get associated products for."
    },
    "ProductListFilterValue": {
      "required": [
        "filterValueId"
      ],
      "type": "object",
      "properties": {
        "filterValueId": {
          "type": "string",
          "description": "The unique identifier of the filter value."
        }
      },
      "description": "The list of filter values in this filter."
    }
  }
}