{ "openapi": "3.0.1", "info": { "title": "Selling Partner API for Catalog Items", "description": "The Selling Partner API for Catalog Items helps you programmatically retrieve item details for items in the catalog.", "contact": { "name": "Selling Partner API Developer Support", "url": "https://sellercentral.amazon.com/gp/mws/contactus.html" }, "license": { "name": "Apache License 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "v0" }, "servers": [ { "url": "https://sellingpartnerapi-na.amazon.com/" } ], "paths": { "/catalog/v0/categories": { "get": { "tags": [ "CatalogItemsV0" ], "description": "Returns the parent categories to which an item belongs, based on the specified ASIN or SellerSKU.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "listCatalogCategories", "parameters": [ { "name": "MarketplaceId", "in": "query", "description": "A marketplace identifier. Specifies the marketplace for the item.", "required": true, "schema": { "type": "string" } }, { "name": "ASIN", "in": "query", "description": "The Amazon Standard Identification Number (ASIN) of the item.", "schema": { "type": "string" } }, { "name": "SellerSKU", "in": "query", "description": "Used to identify items in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "MarketplaceId": { "value": "TEST_CASE_200" }, "ASIN": { "value": "asin_200" } } }, "response": { "payload": [ { "ProductCategoryId": "26752675", "ProductCategoryName": "Project Management", "parent": {} }, { "ProductCategoryId": "468220445", "ProductCategoryName": "Art", "parent": {} } ] } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "MarketplaceId": { "value": "TEST_CASE_400" }, "ASIN": { "value": "ASIN_TO_TEST" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } } }, "403": { "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } } }, "404": { "description": "The specified resource does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCatalogCategoriesResponse" } } } } } } } }, "components": { "schemas": { "ListCatalogCategoriesResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/ListOfCategories" }, "errors": { "$ref": "#/components/schemas/ErrorList" } } }, "ListOfCategories": { "type": "array", "items": { "$ref": "#/components/schemas/Categories" } }, "Categories": { "type": "object", "properties": { "ProductCategoryId": { "type": "string", "description": "The identifier for the product category (or browse node)." }, "ProductCategoryName": { "type": "string", "description": "The name of the product category (or browse node)." }, "parent": { "type": "object", "properties": {}, "description": "The parent product category." } } }, "ErrorList": { "required": [ "errors" ], "type": "object", "description": "A list of error responses returned when a request is unsuccessful.", "properties": { "errors": { "type": "array", "description": "A list of error responses returned when a request is unsuccessful.", "items": { "$ref": "#/components/schemas/Error" } } } }, "Error": { "required": [ "code", "message" ], "type": "object", "properties": { "code": { "type": "string", "description": "An error code that identifies the type of error that occurred." }, "message": { "type": "string", "description": "A message that describes the error condition in a human-readable form." }, "details": { "type": "string", "description": "Additional information that can help the caller understand or fix the issue." } }, "description": "Error response returned when the request is unsuccessful." } } }, "x-original-swagger-version": "2.0" }