ProductDetails

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/barcodes-gg/main/json-schema/barcodes-gg-product-details-schema.json",
  "title": "ProductDetails",
  "description": "Merged product record with the full size run.",
  "x-generated": "2026-10-21",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/barcodes-gg-openapi.json#/components/schemas/ProductDetails",
  "type": "object",
  "properties": {
    "sku": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "colourway": {
      "type": "string"
    },
    "category": {
      "type": [
        "string",
        "object",
        "null"
      ]
    },
    "title": {
      "type": "string"
    },
    "brand": {
      "type": "string"
    },
    "nickname": {
      "type": "string"
    },
    "designer": {
      "type": "string"
    },
    "main_color": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "product_unique_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "v2 only."
    },
    "gender": {
      "type": "string"
    },
    "upper_material": {
      "type": "string"
    },
    "release_date": {
      "type": "string"
    },
    "release_date_formatted": {
      "type": "string",
      "description": "DD/MM/YYYY, or empty."
    },
    "retail_price": {
      "type": [
        "integer",
        "number",
        "string",
        "null"
      ]
    },
    "retail_price_gbp": {
      "type": [
        "integer",
        "number",
        "string",
        "null"
      ]
    },
    "retail_price_usd": {
      "type": [
        "integer",
        "number",
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "stockx_total_sold": {
      "type": [
        "integer",
        "string",
        "null"
      ]
    },
    "image": {
      "type": "string",
      "format": "uri"
    },
    "sizes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SizeRunEntry"
      }
    },
    "variants": {
      "type": "integer",
      "description": "Number of sizes."
    },
    "variant_format": {
      "type": "string",
      "description": "UK or N/A."
    },
    "size_run": {
      "type": "string",
      "description": "First and last size, for example `3 - 14`."
    },
    "internal_category": {
      "type": "string",
      "description": "Sneakers, Clothing, Accessories or Collectibles."
    },
    "search_sku": {
      "type": "string"
    },
    "goat_image": {
      "type": "string",
      "description": "v2 with show_images=1 only."
    },
    "stockx_image": {
      "type": "string",
      "description": "v2 with show_images=1 only."
    },
    "product_images": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "v2 with show_images=1 only."
    }
  },
  "$defs": {
    "SizeRunEntry": {
      "type": "object",
      "description": "One size of a product with its barcodes. `ean` and `upc` are empty strings when no barcode is held for the size.",
      "properties": {
        "eu": {
          "type": "string"
        },
        "uk": {
          "type": "string"
        },
        "us": {
          "type": "string"
        },
        "ean": {
          "type": "string"
        },
        "upc": {
          "type": "string"
        }
      }
    }
  }
}