Bol · Schema

RetailerInformationResponse

E-CommerceRetailMarketplaceNetherlands

Properties

Name Type Description
retailerId string The Id of the retailer which information belongs to.
displayName string The name of the retailer visible on bol.com
companyName string The company name of the retailer.
vatNumber string The VAT number of the retailer.
kvkNumber stringnull The KVK number of the retailer.
registrationDate string A date representing the registration date for the retailer within bol.com
topRetailer booleannull Indication of retailer's being the top seller.
ratingMethod stringnull An identifier that identifies if the rating is calculated over the past three months or on all reviews for the retailer.
retailerRating object
retailerReview object
View JSON Schema on GitHub

JSON Schema

bol-com-retailer-information-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bol-com/json-schema/bol-com-retailer-information-response-schema.json",
  "title": "RetailerInformationResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bol-com-retailers-api-openapi.yml#/components/schemas/RetailerInformationResponse",
  "required": [
    "companyName",
    "displayName",
    "kvkNumber",
    "registrationDate",
    "retailerId",
    "vatNumber"
  ],
  "type": "object",
  "properties": {
    "retailerId": {
      "type": "string",
      "description": "The Id of the retailer which information belongs to."
    },
    "displayName": {
      "type": "string",
      "description": "The name of the retailer visible on bol.com"
    },
    "companyName": {
      "type": "string",
      "description": "The company name of the retailer."
    },
    "vatNumber": {
      "type": "string",
      "description": "The VAT number of the retailer."
    },
    "kvkNumber": {
      "type": [
        "string",
        "null"
      ],
      "description": "The KVK number of the retailer."
    },
    "registrationDate": {
      "type": "string",
      "description": "A date representing the registration date for the retailer within bol.com"
    },
    "topRetailer": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indication of retailer's being the top seller."
    },
    "ratingMethod": {
      "type": [
        "string",
        "null"
      ],
      "description": "An identifier that identifies if the rating is calculated over the past three months or on all reviews for the retailer.",
      "enum": [
        "ALL_REVIEWS",
        "THREE_MONTHS",
        null
      ]
    },
    "retailerRating": {
      "allOf": [
        {
          "$ref": "#/$defs/RetailerRating"
        }
      ]
    },
    "retailerReview": {
      "allOf": [
        {
          "$ref": "#/$defs/RetailerReview"
        }
      ]
    }
  },
  "$defs": {
    "RetailerRating": {
      "required": [
        "retailerRating"
      ],
      "type": "object",
      "properties": {
        "retailerRating": {
          "maximum": 10,
          "minimum": 1,
          "type": "number",
          "description": "General rating of the retailer.",
          "format": "double"
        },
        "productInformationRating": {
          "maximum": 10,
          "minimum": 1,
          "type": [
            "number",
            "null"
          ],
          "description": "Product rating of the retailer.",
          "format": "double"
        },
        "deliveryTimeRating": {
          "maximum": 10,
          "minimum": 1,
          "type": [
            "number",
            "null"
          ],
          "description": "Delivery rating of the retailer.",
          "format": "double"
        },
        "shippingRating": {
          "maximum": 10,
          "minimum": 1,
          "type": [
            "number",
            "null"
          ],
          "description": "Shipping rating of the retailer.",
          "format": "double"
        },
        "serviceRating": {
          "maximum": 10,
          "minimum": 1,
          "type": [
            "number",
            "null"
          ],
          "description": "Service rating of the retailer.",
          "format": "double"
        }
      },
      "description": "Rating on different aspects all being one decimal precision."
    },
    "RetailerReview": {
      "required": [
        "negativeReviewCount",
        "neutralReviewCount",
        "positiveReviewCount",
        "totalReviewCount"
      ],
      "type": "object",
      "properties": {
        "totalReviewCount": {
          "minimum": 0,
          "type": "integer",
          "description": "The total amount of customer review during that rating method period.",
          "format": "int32"
        },
        "approvalPercentage": {
          "maximum": 10,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ],
          "description": "The percentage of the amount of customer that rated the retailer either neutral or positive during the rating method period.",
          "format": "int32"
        },
        "positiveReviewCount": {
          "minimum": 0,
          "type": "integer",
          "description": "The amount of positive customer reviews during that rating method period.",
          "format": "int32"
        },
        "neutralReviewCount": {
          "minimum": 0,
          "type": "integer",
          "description": "The amount of neutral customer reviews during that rating method period.",
          "format": "int32"
        },
        "negativeReviewCount": {
          "minimum": 0,
          "type": "integer",
          "description": "The amount of negative customer reviews during that rating method period.",
          "format": "int32"
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/bol-com-retailer-information-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.