--- title: "reviewCatalog catalog" method: GET path: "/ops/sellers/{seller_id}/catalog/review" tags: ["ops"] --- # reviewCatalog catalog `GET /ops/sellers/{seller_id}/catalog/review` Fetch paginated products pending review for a seller, including their AI categorization suggestions ## Path parameters - `seller_id` string, regexp, required — Seller ID ## Query parameters - `limit` integer — the size of the page - `page` integer — the index of the page ## Response `200` OK response. - ReviewCatalogResult - `data` Product[], required — Products pending review - `base_rental_price` MoneyAmount - `currency` string, required — Currency code, see ISO 4127 (https://www.iso.org/iso-4217-currency-codes.html) (supported: EUR, GBP, USD) - `gross` integer, required — Gross amount of money, expressed in the minor unit for the currency - `net` integer, required — Net amount of money, expressed in the minor unit for the currency - `categorization_suggestions` ProductCategorizationSuggestion[] — Model categorization suggestions ordered by confidence descending - `category` string, required — Suggested pricing category - `confidence` integer, required — Confidence score (0-100) - `model_name` string, required — Name of the model that produced this suggestion - `model_version` string, required — Version of the model - `description` string — Description of product - `extra_details` ExtraProductDetails[] — Extra details about the product such as CPU, Memory, storage... - `property` string, required — Name of the property - `value` string, required - `id` string, regexp, required — topi Product ID - `image` ProductImage - `url` string, uri — Url hosting the image - `is_active` boolean, required — If product is still active - `is_fully_reviewed` boolean, required — Whether this product has been marked as fully reviwed - `list_price` MoneyAmount - `currency` string, required — Currency code, see ISO 4127 (https://www.iso.org/iso-4217-currency-codes.html) (supported: EUR, GBP, USD) - `gross` integer, required — Gross amount of money, expressed in the minor unit for the currency - `net` integer, required — Net amount of money, expressed in the minor unit for the currency - `manufacturer` string — The product manufacturer - `origin` string — origin of the product, 'manual' for topi tool, 'automatic' for catalog ingestion - `origin_seller` string — the seller origin for central catalog - `origin_seller_references` SellerProductReference[] — the origin seller references for the central catalog - `reference` string, required — The ID related with the source. This value should be unique for that source. - `source` string, required — The seller internal source name for this reference type. - `pretty_id` string — The visual overriding id of the product - `pricing_category` 'iphone_17' | 'iphone_17_pro' | 'iphone_17_pro_max' | 'iphone_air' | 'iphone_17_e' | 'iphone_16_pro_max' | 'iphone_16_pro' | 'iphone_16_plus' | 'iphone_16' | 'iphone_15_pro_max' | 'iphone_15_pro' | 'iphone_15_plus' | 'iphone_15' | 'iphone_14_pro_max' | 'iphone_14_pro' | 'iphone_14_plus' | 'iphone_14' | 'iphone_13_pro_max' | 'iphone_13_pro' | 'iphone_13' | 'iphone_12' | 'iphone_11' | 'iphone_se_22' | 'iphone_se_20' | 'macbook_pro_13_14' | 'macbook_pro_13_14_m3' | 'macbook_pro_13_14_m4' | 'macbook_pro_13_14_m5' | 'macbook_pro_15_16' | 'macbook_pro_15_16_m3' | 'macbook_pro_15_16_m4' | 'macbook_pro_15_16_m5' | 'macbook_air' | 'macbook_air_13_m5' | 'macbook_air_15_m5' | 'macbook_neo' | 'mac_desktop' | 'mac_desktop_m4' | 'mac_studio' | 'mac_pro_m2' | 'apple_display' | 'studio_display_2026' | 'studio_display_2022' | 'studio_display_xdr' | 'ipad_pro' | 'ipad_pro_m5' | 'ipad_pro_m4' | 'ipad_pro_12_9_inch_7_gen' | 'ipad_pro_12_9_inch_6_gen' | 'ipad_pro_12_9_inch_5_gen' | 'ipad_pro_11_inch_4_gen' | 'ipad_air' | 'ipad_air_m4' | 'ipad_air_m3' | 'ipad_air_6_gen' | 'ipad_air_5_gen' | 'ipad_air_4_gen' | 'ipad_regular' | 'ipad_regular_11_gen' | 'ipad_regular_10_gen' | 'ipad_regular_9_gen' | 'ipad_mini' | 'ipad_mini_6_gen' | 'smartwatch_apple' | 'smartwatch_apple_ultra' | 'smartwatch_other' | 'laptop_other_top' | 'laptop_other_low' | 'desktop_other_top' | 'desktop_other_low' | 'phone_other_top' | 'phone_other_low' | 'tablet_other_top' | 'tablet_other_low' | 'screen' | 'accessory_other' | 'accessory_airpods' | 'accessory_pencil' | 'accessory_homepod' | 'accessory_visionpro' | 'services_insurance' | 'software' | 'services_management' | 'printer' | 'iphone_16_e' | 'server' | 'network_security' | 'mac_pro' | 'mac_studio_m3' | 'mac_studio_m4' | 'accessory_smartfolio' | 'accessory_appletv' | 'accessory_gpu' | '' — The pricing category that should be assigned - `pricing_category_confidence` integer — Optional confidence of the category classification - `pricing_input_information` PricingInputInformation, required - `headroom_info` Headroom[] - `expected_residual_value_ratio` number, double, required — Expected residual value ratio for this tenure - `headroom_ratio` number, double, required — Headroom ratio applied to this product for this tenure - `is_default` boolean, required — Whether this tenure is the default tenure - `tenure` integer, required — The tenure in months (6, 12, 24, or 36) - `pricing_category` string — Pricing category of the product - `pricing_category_confidence` integer — Confidence that the assignment of the category is correct - `product_standard_identifiers` ProductStandardIdentifier[] — Standard identifiers for this product - `id` string — The product identifier value - `identifier_type` string — The kind of identifier standard - `publicized_price` MoneyAmount, required - `currency` string, required — Currency code, see ISO 4127 (https://www.iso.org/iso-4217-currency-codes.html) (supported: EUR, GBP, USD) - `gross` integer, required — Gross amount of money, expressed in the minor unit for the currency - `net` integer, required — Net amount of money, expressed in the minor unit for the currency - `review_status` 'supported' | 'unsupported' | 'to_be_reviewed', required - `seller_categories` ProductSellerCategory[] — Categories from the seller - `id` string, required - `name` string, required - `parent_category` string - `seller_product_references` SellerProductReference[], required — Partner's own reference for this product - `reference` string, required — The ID related with the source. This value should be unique for that source. - `source` string, required — The seller internal source name for this reference type. - `seller_product_type` 'hardware' | 'software' | 'service' | 'hardware_built_to_order' - `shop_product_description_url` string, uri - `subtitle` string — Subtitle of product - `title` string, required — Name for product - `pagination` PaginationMetadata, required - `page` integer — Current page number - `page_size` integer — Number of items per page - `total_count` integer — Total number of items - `total_pages` integer — Total number of pages ## Other responses - `401` — Unauthorized: Unauthorized response. - `403` — InvalidScopes: Forbidden response. - `404` — NotFound: Not Found response. --- [API](https://skmtc.net/topi/apis/topi-public-api.md) · [All operations](https://skmtc.net/topi/apis/topi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topi/topi-public-api/revisions/f4208dbc3eb3/schema)