{"openapi":"3.1.0","info":{"title":"Sambit Public API","description":"Public catalog endpoints for product discovery, category browsing, and benchmark-aware filtering.","version":"1.0.0","x-generated-for":"seo-geo-public"},"paths":{"/health":{"get":{"summary":"Liveness probe","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Check Health Get"}}}}}}},"/health/db":{"get":{"summary":"Readiness probe","operationId":"health_database_check_health_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Database Check Health Db Get"}}}}}}},"/api/v1/catalog/media/proxy":{"get":{"tags":["catalog"],"summary":"Proxy External Media","operationId":"proxy_external_media_api_v1_catalog_media_proxy_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":8,"title":"Url"}},{"name":"w","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Resize width (px)","title":"W"},"description":"Resize width (px)"},{"name":"h","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Resize height (px)","title":"H"},"description":"Resize height (px)"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Output quality (40-95)","title":"Q"},"description":"Output quality (40-95)"},{"name":"fmt","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Output format (jpeg/webp/png)","title":"Fmt"},"description":"Output format (jpeg/webp/png)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/media/{media_id}":{"get":{"tags":["catalog"],"summary":"Proxy Product Media","operationId":"proxy_product_media_api_v1_catalog_media__media_id__get","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","title":"Media Id"}},{"name":"w","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Resize width (px)","title":"W"},"description":"Resize width (px)"},{"name":"h","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Resize height (px)","title":"H"},"description":"Resize height (px)"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Output quality (40-95)","title":"Q"},"description":"Output quality (40-95)"},{"name":"fmt","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Output format (jpeg/webp/png)","title":"Fmt"},"description":"Output format (jpeg/webp/png)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/categories":{"get":{"tags":["catalog"],"summary":"List Categories","operationId":"list_categories_api_v1_catalog_categories_get","parameters":[{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Locale (e.g. lt, en)","title":"Locale"},"description":"Locale (e.g. lt, en)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CuratedCategoryRead"},"title":"Response List Categories Api V1 Catalog Categories Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/products":{"get":{"tags":["catalog"],"summary":"List Products","operationId":"list_products_api_v1_catalog_products_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"description":"Opaque cursor for keyset pagination.","title":"Cursor"},"description":"Opaque cursor for keyset pagination."},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search query (preferred alias).","title":"Q"},"description":"Search query (preferred alias)."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search query (legacy alias).","title":"Search"},"description":"Search query (legacy alias)."},{"name":"brand","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Case-insensitive brand filter.","title":"Brand"},"description":"Case-insensitive brand filter."},{"name":"vendor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Vendor Id"}},{"name":"category_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"-created_at","title":"Sort"}},{"name":"price_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Price Min"}},{"name":"price_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Price Max"}},{"name":"reach_cm_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":300,"minimum":0},{"type":"null"}],"title":"Reach Cm Min"}},{"name":"reach_cm_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":300,"minimum":0},{"type":"null"}],"title":"Reach Cm Max"}},{"name":"capacity_gb_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":200000,"minimum":1},{"type":"null"}],"title":"Capacity Gb Min"}},{"name":"capacity_gb_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":200000,"minimum":1},{"type":"null"}],"title":"Capacity Gb Max"}},{"name":"attributes","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Attribute filters in key:value format (e.g. attributes=brand:ASUS)","title":"Attributes"},"description":"Attribute filters in key:value format (e.g. attributes=brand:ASUS)"},{"name":"include_in_stock","in":"query","required":false,"schema":{"type":"boolean","description":"Include immediately in-stock products","default":true,"title":"Include In Stock"},"description":"Include immediately in-stock products"},{"name":"in_stock_only","in":"query","required":false,"schema":{"type":"boolean","description":"Legacy alias for local-stock-only products","default":false,"title":"In Stock Only"},"description":"Legacy alias for local-stock-only products"},{"name":"include_preorder","in":"query","required":false,"schema":{"type":"boolean","description":"Include ES warehouse/preorder items","default":true,"title":"Include Preorder"},"description":"Include ES warehouse/preorder items"},{"name":"include_out_of_stock","in":"query","required":false,"schema":{"type":"boolean","description":"Include out-of-stock items","default":false,"title":"Include Out Of Stock"},"description":"Include out-of-stock items"},{"name":"exclude_demo","in":"query","required":false,"schema":{"type":"boolean","description":"Legacy param; public visibility is enforced server-side","default":false,"title":"Exclude Demo"},"description":"Legacy param; public visibility is enforced server-side"},{"name":"include_facets","in":"query","required":false,"schema":{"type":"boolean","description":"Include facet/filter payloads","default":true,"title":"Include Facets"},"description":"Include facet/filter payloads"},{"name":"taxonomy","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by curated taxonomy slug (e.g. pc-components)","title":"Taxonomy"},"description":"Filter by curated taxonomy slug (e.g. pc-components)"},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Locale (e.g. lt, en)","title":"Locale"},"description":"Locale (e.g. lt, en)"},{"name":"compact","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Return a list-optimized payload.","title":"Compact"},"description":"Return a list-optimized payload."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/highlights":{"get":{"tags":["catalog"],"summary":"Get Catalog Highlights","operationId":"get_catalog_highlights_api_v1_catalog_highlights_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":6,"title":"Limit"}},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Locale (e.g. lt, en)","title":"Locale"},"description":"Locale (e.g. lt, en)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogHighlights"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/variants/{variant_id}/price-history":{"get":{"tags":["catalog"],"summary":"Get Variant Price History","operationId":"get_variant_price_history_api_v1_catalog_variants__variant_id__price_history_get","parameters":[{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Variant Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":180,"minimum":1,"default":30,"title":"Limit"}},{"name":"fulfillment_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional opaque fulfillment key to return one provider price line.","title":"Fulfillment Key"},"description":"Optional opaque fulfillment key to return one provider price line."},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Locale (e.g. lt, en)","title":"Locale"},"description":"Locale (e.g. lt, en)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CatalogPricePoint"},"title":"Response Get Variant Price History Api V1 Catalog Variants  Variant Id  Price History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/variants/resolve":{"post":{"tags":["catalog"],"summary":"Resolve Variant Vendors","operationId":"resolve_variant_vendors_api_v1_catalog_variants_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VariantVendorResolutionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/VariantVendorResolution"},"type":"array","title":"Response Resolve Variant Vendors Api V1 Catalog Variants Resolve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/products/{product_ref}":{"get":{"tags":["catalog"],"summary":"Get Product","operationId":"get_product_api_v1_catalog_products__product_ref__get","parameters":[{"name":"product_ref","in":"path","required":true,"schema":{"title":"Product Ref"}},{"name":"sku","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional SKU fallback when resolving a product reference","title":"Sku"},"description":"Optional SKU fallback when resolving a product reference"},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Locale (e.g. lt, en)","title":"Locale"},"description":"Locale (e.g. lt, en)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/products/{product_ref}/related":{"get":{"tags":["catalog"],"summary":"Get Related Products","operationId":"get_related_products_api_v1_catalog_products__product_ref__related_get","parameters":[{"name":"product_ref","in":"path","required":true,"schema":{"type":"string","title":"Product Ref"}},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Locale (e.g. lt, en)","title":"Locale"},"description":"Locale (e.g. lt, en)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":24,"minimum":1,"default":8,"title":"Limit"}},{"name":"compact","in":"query","required":false,"schema":{"type":"boolean","description":"Return compact product-card payloads instead of full product detail objects","default":false,"title":"Compact"},"description":"Return compact product-card payloads instead of full product detail objects"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelatedProductsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/catalog/autocomplete":{"get":{"tags":["catalog"],"summary":"Search Autocomplete","operationId":"search_autocomplete_api_v1_catalog_autocomplete_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Max suggestions to return","default":10,"title":"Limit"},"description":"Max suggestions to return"},{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Locale for localized suggestions","title":"Locale"},"description":"Locale for localized suggestions"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutocompleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/health":{"get":{"tags":["health"],"summary":"Liveness probe","operationId":"health_check_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Check Api V1 Health Get"}}}}}}},"/api/v1/health/db":{"get":{"tags":["health"],"summary":"Readiness probe","operationId":"health_database_check_api_v1_health_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Database Check Api V1 Health Db Get"}}}}}}}},"components":{"schemas":{"AnalogueNoticeRead":{"properties":{"kind":{"type":"string","title":"Kind"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Explanation"},"compatible_with":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compatible With"},"alternatives":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alternatives"},"oem_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oem Code"},"printer_models":{"items":{"type":"string"},"type":"array","title":"Printer Models"}},"type":"object","required":["kind"],"title":"AnalogueNoticeRead","description":"Shopper copy for a compatible item, or the alternatives line on an original."},"AutocompleteResponse":{"properties":{"query":{"type":"string","title":"Query","description":"Original search query"},"suggestions":{"items":{"$ref":"#/components/schemas/SearchSuggestion"},"type":"array","title":"Suggestions","description":"List of suggestions sorted by relevance"},"elapsed_ms":{"type":"number","title":"Elapsed Ms","description":"Query execution time in milliseconds","default":0.0}},"type":"object","required":["query"],"title":"AutocompleteResponse","description":"Response for autocomplete/search suggestions endpoint.\n\nProvides fast suggestions for the search input field.\nResults are sorted by relevance: exact matches first, then fuzzy matches."},"AvailabilityStatus":{"type":"string","enum":["in_stock","out_of_stock","preorder","discontinued"],"title":"AvailabilityStatus"},"CatalogHighlights":{"properties":{"price_drops":{"items":{"$ref":"#/components/schemas/ProductHighlightSummary"},"type":"array","title":"Price Drops"},"new_arrivals":{"items":{"$ref":"#/components/schemas/ProductHighlightSummary"},"type":"array","title":"New Arrivals"},"special_offers":{"items":{"$ref":"#/components/schemas/ProductHighlightSummary"},"type":"array","title":"Special Offers"}},"type":"object","title":"CatalogHighlights"},"CatalogPricePoint":{"properties":{"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"price_ex_vat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Ex Vat"},"currency":{"type":"string","title":"Currency"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"},"fulfillment_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfillment Key"},"variant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Variant Id"}},"type":"object","required":["price","currency","recorded_at"],"title":"CatalogPricePoint"},"CuratedCategoryRead":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"product_count":{"type":"integer","title":"Product Count","default":0},"children":{"items":{"$ref":"#/components/schemas/CuratedCategoryRead"},"type":"array","title":"Children"}},"type":"object","required":["slug","name"],"title":"CuratedCategoryRead"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ProductAIEnrichment":{"properties":{"status":{"type":"string","title":"Status"},"comparison_ready":{"type":"boolean","title":"Comparison Ready","default":false},"cart_analysis_ready":{"type":"boolean","title":"Cart Analysis Ready","default":false},"projection_field_count":{"type":"integer","title":"Projection Field Count","default":0},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields"}},"type":"object","required":["status"],"title":"ProductAIEnrichment"},"ProductAvailabilitySummary":{"properties":{"total_variants":{"type":"integer","title":"Total Variants","default":0},"in_stock_variants":{"type":"integer","title":"In Stock Variants","default":0},"units_in_stock":{"type":"integer","title":"Units In Stock","default":0},"units_reserved":{"type":"integer","title":"Units Reserved","default":0},"units_available_for_sale":{"type":"integer","title":"Units Available For Sale","default":0},"by_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Status"}},"type":"object","title":"ProductAvailabilitySummary"},"ProductBenchmarkEnrichment":{"properties":{"status":{"type":"string","title":"Status"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"source_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Class"},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated"},"stale_after_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stale After Days"}},"type":"object","required":["status"],"title":"ProductBenchmarkEnrichment"},"ProductDiscoveryRead":{"properties":{"category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Slug"},"category_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Label"},"taxonomy_path":{"items":{"type":"string"},"type":"array","title":"Taxonomy Path"},"family_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family Slug"},"family_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family Name"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"model_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Number"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"has_media":{"type":"boolean","title":"Has Media","default":false},"media_count":{"type":"integer","title":"Media Count","default":0},"product_kind_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Kind Label"},"catalog_flags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Catalog Flags"}},"type":"object","title":"ProductDiscoveryRead"},"ProductEnrichmentRead":{"properties":{"cpu_benchmark":{"anyOf":[{"$ref":"#/components/schemas/ProductBenchmarkEnrichment"},{"type":"null"}]},"gpu_benchmark":{"anyOf":[{"$ref":"#/components/schemas/ProductBenchmarkEnrichment"},{"type":"null"}]},"ai":{"anyOf":[{"$ref":"#/components/schemas/ProductAIEnrichment"},{"type":"null"}]}},"type":"object","title":"ProductEnrichmentRead"},"ProductHighlightSummary":{"properties":{"product_id":{"type":"string","format":"uuid","title":"Product Id"},"variant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Variant Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"stock_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stock Quantity"},"price_change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Change"},"price_change_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Change Percent"},"previous_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Previous Price"},"recorded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Recorded At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"media_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Url"},"media_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Media Urls"},"catalog_flags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Catalog Flags"},"fulfillment_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfillment Key"},"shipping_profile":{"anyOf":[{"$ref":"#/components/schemas/VendorShippingProfile"},{"type":"null"}]}},"type":"object","required":["product_id","name","slug"],"title":"ProductHighlightSummary"},"ProductMediaRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"url":{"type":"string","title":"Url"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"is_primary":{"type":"boolean","title":"Is Primary"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"}},"type":"object","required":["id","url","is_primary","alt_text"],"title":"ProductMediaRead"},"ProductMediaSummaryRead":{"properties":{"primary_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Url"},"media_count":{"type":"integer","title":"Media Count","default":0},"gallery_count":{"type":"integer","title":"Gallery Count","default":0},"has_primary":{"type":"boolean","title":"Has Primary","default":false}},"type":"object","title":"ProductMediaSummaryRead"},"ProductOfferSelection":{"properties":{"selected_variant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Selected Variant Id"},"strategy":{"type":"string","title":"Strategy"},"source":{"type":"string","title":"Source","default":"backend"}},"type":"object","required":["strategy"],"title":"ProductOfferSelection"},"ProductOfferShippingSummary":{"properties":{"estimated_shipping_cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Shipping Cost"},"free_shipping_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Free Shipping Threshold"},"lead_time_days":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lead Time Days"}},"type":"object","title":"ProductOfferShippingSummary"},"ProductOfferSummaryDescriptor":{"properties":{"availability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Availability"},"shipping_band":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipping Band"},"lead_time_band":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Time Band"}},"type":"object","title":"ProductOfferSummaryDescriptor"},"ProductOfferSummaryEntry":{"properties":{"variant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Variant Id"},"strategy":{"type":"string","title":"Strategy"},"item_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Item Price"},"delivered_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delivered Price"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"fulfillment_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfillment Key"},"descriptor":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSummaryDescriptor"},{"type":"null"}]},"shipping_summary":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferShippingSummary"},{"type":"null"}]}},"type":"object","required":["strategy"],"title":"ProductOfferSummaryEntry"},"ProductOfferSummaryRead":{"properties":{"selected":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSummaryEntry"},{"type":"null"}]},"shopper_selected":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSummaryEntry"},{"type":"null"}]},"cheapest":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSummaryEntry"},{"type":"null"}]},"cheapest_delivered":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSummaryEntry"},{"type":"null"}]},"fastest":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSummaryEntry"},{"type":"null"}]},"offers":{"items":{"$ref":"#/components/schemas/ProductOfferSummaryEntry"},"type":"array","title":"Offers"},"candidate_count":{"type":"integer","title":"Candidate Count","default":0}},"type":"object","title":"ProductOfferSummaryRead"},"ProductPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProductRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"pages":{"type":"integer","title":"Pages"},"current_page":{"type":"integer","title":"Current Page"},"has_next":{"type":"boolean","title":"Has Next"},"has_previous":{"type":"boolean","title":"Has Previous"},"facets":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Facets"},"extra":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","total","limit","offset","pages","current_page","has_next","has_previous"],"title":"ProductPage"},"ProductPricingSummary":{"properties":{"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"min_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price"},"max_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price"},"average_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Price"},"min_price_ex_vat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price Ex Vat"},"max_price_ex_vat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price Ex Vat"},"average_price_ex_vat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Price Ex Vat"},"vat_rate_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vat Rate Percent"}},"type":"object","title":"ProductPricingSummary"},"ProductRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"slug":{"type":"string","title":"Slug"},"sku":{"type":"string","title":"Sku"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"warranty_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Warranty Months"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"normalized_attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Normalized Attributes"},"feature_specs":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Feature Specs"},"fulfillment_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfillment Key"},"shipping_profile":{"anyOf":[{"$ref":"#/components/schemas/VendorShippingProfile"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"availability":{"$ref":"#/components/schemas/ProductAvailabilitySummary"},"pricing":{"$ref":"#/components/schemas/ProductPricingSummary"},"offer_selection":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSelection"},{"type":"null"}]},"offer_summary":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferSummaryRead"},{"type":"null"}]},"spec_summary":{"anyOf":[{"$ref":"#/components/schemas/ProductSpecSummaryRead"},{"type":"null"}]},"discovery":{"anyOf":[{"$ref":"#/components/schemas/ProductDiscoveryRead"},{"type":"null"}]},"media_summary":{"anyOf":[{"$ref":"#/components/schemas/ProductMediaSummaryRead"},{"type":"null"}]},"enrichment":{"anyOf":[{"$ref":"#/components/schemas/ProductEnrichmentRead"},{"type":"null"}]},"analogue":{"anyOf":[{"$ref":"#/components/schemas/AnalogueNoticeRead"},{"type":"null"}]},"value_metrics":{"anyOf":[{"$ref":"#/components/schemas/ProductValueMetricsRead"},{"type":"null"}]},"variants":{"items":{"$ref":"#/components/schemas/ProductVariantRead"},"type":"array","title":"Variants"},"media":{"items":{"$ref":"#/components/schemas/ProductMediaRead"},"type":"array","title":"Media"}},"type":"object","required":["id","name","slug","sku","description","brand","warranty_months","attributes","created_at","updated_at"],"title":"ProductRead"},"ProductSpecSummaryEntry":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"value":{"type":"string","title":"Value"}},"type":"object","required":["key","label","value"],"title":"ProductSpecSummaryEntry"},"ProductSpecSummaryRead":{"properties":{"source":{"type":"string","title":"Source"},"item_count":{"type":"integer","title":"Item Count","default":0},"items":{"items":{"$ref":"#/components/schemas/ProductSpecSummaryEntry"},"type":"array","title":"Items"}},"type":"object","required":["source"],"title":"ProductSpecSummaryRead"},"ProductValueMetricsRead":{"properties":{"price_per_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Per Gb"},"price_per_tb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Per Tb"},"price_per_ghz":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Per Ghz"}},"type":"object","title":"ProductValueMetricsRead","description":"Shopper-facing unit prices used for value sorting and comparison."},"ProductVariantRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"estimated_shipping_cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Shipping Cost"},"price_ex_vat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Ex Vat"},"vat_rate_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vat Rate Percent"},"vat_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vat Amount"},"currency":{"type":"string","title":"Currency"},"stock_quantity":{"type":"integer","title":"Stock Quantity"},"reserved_quantity":{"type":"integer","title":"Reserved Quantity","default":0},"salable_quantity":{"type":"integer","title":"Salable Quantity","default":0},"availability":{"$ref":"#/components/schemas/AvailabilityStatus"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"weight_grams":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Weight Grams"},"dimension_mm":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dimension Mm"},"is_active":{"type":"boolean","title":"Is Active","default":true},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"fulfillment_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfillment Key"},"shipping_profile":{"anyOf":[{"$ref":"#/components/schemas/VendorShippingProfile"},{"type":"null"}]},"is_purchasable":{"type":"boolean","title":"Is Purchasable","default":false},"is_preorder_available":{"type":"boolean","title":"Is Preorder Available","default":false},"availability_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Availability Label"},"availability_status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Availability Status Label"},"stock_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stock Label"},"stock_count_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stock Count Label"},"shipping_summary_lines":{"items":{"type":"string"},"type":"array","title":"Shipping Summary Lines"}},"type":"object","required":["id","name","currency","stock_quantity","availability","attributes"],"title":"ProductVariantRead"},"ProductVendorSummary":{"properties":{"shipping_profile":{"anyOf":[{"$ref":"#/components/schemas/VendorShippingProfile"},{"type":"null"}]}},"type":"object","title":"ProductVendorSummary"},"RelatedProductsResponse":{"properties":{"taxonomy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy"},"items":{"items":{"$ref":"#/components/schemas/ProductRead"},"type":"array","title":"Items"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","title":"RelatedProductsResponse"},"SearchSuggestion":{"properties":{"text":{"type":"string","title":"Text","description":"Suggestion text to display"},"type":{"type":"string","title":"Type","description":"Type: 'product', 'category', 'brand', 'model'"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug","description":"Product slug for direct navigation"},"score":{"type":"number","title":"Score","description":"Relevance score (higher is better)","default":0.0},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Category for context"}},"type":"object","required":["text","type"],"title":"SearchSuggestion","description":"Single search suggestion with type and relevance score."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VariantVendorResolution":{"properties":{"variant_id":{"type":"string","format":"uuid","title":"Variant Id"},"fulfillment_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfillment Key"},"product_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"}},"type":"object","required":["variant_id"],"title":"VariantVendorResolution"},"VariantVendorResolutionRequest":{"properties":{"variant_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Variant Ids"}},"type":"object","title":"VariantVendorResolutionRequest"},"VendorShippingProfile":{"properties":{"cutoff_hour_local":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cutoff Hour Local"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"lead_time_days":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lead Time Days"},"weekend_delivery":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Weekend Delivery"},"free_shipping_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Free Shipping Threshold"},"shipping_fee_under_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipping Fee Under Threshold"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"summary_lines":{"items":{"type":"string"},"type":"array","title":"Summary Lines"}},"type":"object","title":"VendorShippingProfile"},"WarehouseStockEntry":{"properties":{"warehouse_id":{"type":"integer","title":"Warehouse Id"},"warehouse_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warehouse Code"},"warehouse_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warehouse Label"},"stock":{"type":"integer","title":"Stock","default":0}},"type":"object","required":["warehouse_id"],"title":"WarehouseStockEntry"}}}}