getCatalogItem

Effective September 30, 2022, the getCatalogItem operation will no longer be available in the Selling Partner API for Catalog Items v0. This operation is available in the latest version of the Selling Partner API for Catalog Items v2022-04-01. Integrations that rely on this operation should migrate to the latest version to avoid service disruption.
Note: The listCatalogCategories operation is not being deprecated and you can continue to make calls to it.

Responses

🟢200OK

application/json

Success.

Headers

x-amzn-RateLimit-Limit

string

optional

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

optional

Unique request reference ID.

Body

payload

object (Item)

optional

A listings item.

sku

string

required

A selling partner provided identifier for an Amazon listing.

summaries

array[object (ItemSummaryByMarketplace) {10}]

optional

Summary details of a listings item.

attributes

object (ItemAttributes)

optional

A JSON object containing structured listings item attribute data keyed by attribute name.

issues

array[object (Issue) {6}]

optional

The issues associated with the listings item.

offers

array[object (ItemOfferByMarketplace) {5}]

optional

Offer details for the listings item.

fulfillmentAvailability

array[object (FulfillmentAvailability) {2}]

optional

The fulfillment availability for the listings item.

procurement

array[object (ItemProcurement) {1}]

optional

The vendor procurement information for the listings item.

errors

array[object (Error) {3}]

optional

A list of error responses that are returned when a request is unsuccessful.

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition.

details

string

optional

Additional details that can help the caller understand or fix the issue.

Example

{
    "payload": {
        "sku": "string",
        "summaries": [
            {
                "marketplaceId": "string",
                "asin": "string",
                "productType": "string",
                "conditionType": "new_new",
                "status": [
                    "BUYABLE"
                ],
                "fnSku": "string",
                "itemName": "string",
                "createdDate": "2019-08-24T14:15:22Z",
                "lastUpdatedDate": "2019-08-24T14:15:22Z",
                "mainImage": {
                    "link": "string",
                    "height": 0,
                    "width": 0
                }
            }
        ],
        "attributes": {},
        "issues": [
            {
                "code": "string",
                "message": "string",
                "severity": "ERROR",
                "attributeNames": [
                    "string"
                ],
                "categories": [
                    "INVALID_ATTRIBUTE"
                ],
                "enforcements": {
                    "actions": [
                        {
                            "action": "LISTING_SUPPRESSED"
                        }
                    ],
                    "exemption": {
                        "status": "EXEMPT",
                        "expiryDate": "2023-10-28T00:36:48.914Z"
                    }
                }
            }
        ],
        "offers": [
            {
                "marketplaceId": "string",
                "offerType": "B2C",
                "price": {
                    "currencyCode": "string",
                    "amount": "string"
                },
                "points": {
                    "pointsNumber": 0,
                    "pointsMonetaryValue": {
                        "currencyCode": "string",
                        "amount": 0
                    }
                },
                "audience": {
                    "value": "ALL",
                    "displayName": "string"
                }
            }
        ],
        "fulfillmentAvailability": [
            {
                "fulfillmentChannelCode": "string",
                "quantity": 0
            }
        ],
        "procurement": [
            {
                "costPrice": {
                    "currencyCode": "string",
                    "amount": "string"
                }
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429429

🔴500Server Error

🔴503Service Unavailable

Request

Request samples

Responses