ListingsItemSubmissionResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/main/json-schema/amazon-seller-central-listings-item-submission-response-schema.json",
  "title": "ListingsItemSubmissionResponse",
  "description": "Response containing the results of a submission to the Selling Partner API for Listings Items.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-listings-api-openapi.yml#/components/schemas/ListingsItemSubmissionResponse",
  "properties": {
    "sku": {
      "description": "A selling partner-provided identifier for an Amazon listing.",
      "type": "string"
    },
    "status": {
      "description": "The status of the listings item submission.",
      "enum": [
        "ACCEPTED",
        "INVALID",
        "VALID"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "ACCEPTED",
          "description": "The listings submission was accepted for processing."
        },
        {
          "value": "INVALID",
          "description": "The listings submission was not valid and was not accepted for processing."
        },
        {
          "value": "VALID",
          "description": "The listings submission was valid. Only returned when the `mode` is `VALIDATION_PREVIEW`."
        }
      ],
      "type": "string"
    },
    "submissionId": {
      "description": "The unique identifier of the listings item submission.",
      "type": "string"
    },
    "issues": {
      "description": "Listings item issues related to the listings item submission.",
      "type": "array",
      "items": {
        "$ref": "#/$defs/Issue"
      }
    },
    "identifiers": {
      "description": "Identity attributes associated with the item in the Amazon catalog, such as the ASIN.",
      "$ref": "#/$defs/ItemIdentifiers"
    }
  },
  "required": [
    "sku",
    "status",
    "submissionId"
  ],
  "type": "object",
  "$defs": {
    "Issue": {
      "description": "An issue with a listings item.",
      "properties": {
        "code": {
          "description": "An issue code that identifies the type of issue.",
          "type": "string"
        },
        "message": {
          "description": "A message that describes the issue.",
          "type": "string"
        },
        "severity": {
          "description": "The severity of the issue.",
          "enum": [
            "ERROR",
            "WARNING",
            "INFO"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "ERROR",
              "description": "Indicates an issue has occurred preventing the submission from processing, such as a validation error."
            },
            {
              "value": "WARNING",
              "description": "Indicates an issue has occurred that should be reviewed, but has not prevented the submission from processing."
            },
            {
              "value": "INFO",
              "description": "Indicates additional information has been provided that should be reviewed."
            }
          ],
          "type": "string"
        },
        "attributeNames": {
          "description": "Names of the attributes that are associated with the issue, if applicable.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "categories": {
          "description": "List of issue categories.",
          "type": "array",
          "items": {
            "type": "string",
            "x-docgen-enum-table-extension": [
              {
                "value": "INVALID_ATTRIBUTE",
                "description": "One or more attributes are invalid."
              },
              {
                "value": "MISSING_ATTRIBUTE",
                "description": "One or more required attributes are missing."
              },
              {
                "value": "INVALID_IMAGE",
                "description": "One or more images are invalid."
              },
              {
                "value": "MISSING_IMAGE",
                "description": "One or more required images are missing."
              },
              {
                "value": "INVALID_PRICE",
                "description": "One or more price attributes are invalid."
              },
              {
                "value": "MISSING_PRICE",
                "description": "One or more required price attributes are missing."
              },
              {
                "value": "DUPLICATE",
                "description": "The listing has potential duplicate problems, such as this ASIN potentially being a duplicate of another ASIN."
              },
              {
                "value": "QUALIFICATION_REQUIRED",
                "description": "Approval or qualification is required to list the product."
              },
              {
                "value": "PRODUCT",
                "description": "Issue applies to the product (ASIN)."
              },
              {
                "value": "LISTING",
                "description": "Issue applies to the listing (SKU)."
              }
            ]
          }
        },
        "enforcements": {
          "description": "Provides information about the enforcement actions taken by Amazon that affect the publishing or status of a listing. It also includes details about any associated exemptions.",
          "$ref": "#/$defs/IssueEnforcements"
        },
        "marketplaceIds": {
          "description": "List of Amazon store identifiers.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "code",
        "message",
        "severity",
        "categories"
      ],
      "type": "object"
    },
    "IssueEnforcementAction": {
      "description": "The enforcement action taken by Amazon that affect the publishing or status of a listing",
      "type": "object",
      "properties": {
        "action": {
          "description": "The enforcement action name. \n\nPossible values: \n\n* `LISTING_SUPPRESSED` - This enforcement takes down the current listing item's buyability. \n\n* `ATTRIBUTE_SUPPRESSED` - An attribute's value on the listing item is invalid, which causes it to be rejected by Amazon. \n\n* `CATALOG_ITEM_REMOVED` - This catalog item is inactive on Amazon, and all offers against it in the applicable Amazon store are non-buyable. \n\n* `SEARCH_SUPPRESSED` - This value indicates that the catalog item is hidden from search results.",
          "type": "string"
        }
      },
      "required": [
        "action"
      ]
    },
    "IssueEnforcements": {
      "description": "Provides information about the enforcement actions taken by Amazon that affect the publishing or status of a listing. It also includes details about any associated exemptions.",
      "type": "object",
      "properties": {
        "actions": {
          "description": "List of enforcement actions taken by Amazon that affect the publishing or status of a listing.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/IssueEnforcementAction"
          }
        },
        "exemption": {
          "description": "The `exemption` field serves to convey the status of enforcement actions by Amazon.",
          "$ref": "#/$defs/IssueExemption"
        }
      },
      "required": [
        "actions",
        "exemption"
      ]
    },
    "IssueExemption": {
      "description": "Conveying the status of the listed enforcement actions and, if applicable, provides information about the exemption's expiry date.",
      "type": "object",
      "properties": {
        "status": {
          "description": "Indicates the current exemption status for the listed enforcement actions. It can take values such as `EXEMPT`, signifying permanent exemption, `EXEMPT_UNTIL_EXPIRY_DATE` indicating temporary exemption until a specified date, or `NOT_EXEMPT` signifying no exemptions, and enforcement actions were already applied.",
          "enum": [
            "EXEMPT",
            "EXEMPT_UNTIL_EXPIRY_DATE",
            "NOT_EXEMPT"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "EXEMPT",
              "description": "This status is assigned to a product listing when it has been exempted from the listed enforcement actions. In cases of `EXEMPT`, Amazon acknowledges the existence of enforcement actions but ensures the user that these actions are not applied to the listing. The user is advised to consider addressing the issue, although enforcement actions are not taken."
            },
            {
              "value": "EXEMPT_UNTIL_EXPIRY_DATE",
              "description": "This status indicates that a product listing has been granted a temporary exemption from the listed enforcement actions. The exemption remains in effect until a specified expiry date. After this date, Amazon enforces the listed actions. The `expiryDate` field provides the timestamp indicating when the temporary exemption ends, adhering to the ISO 8601 format"
            },
            {
              "value": "NOT_EXEMPT",
              "description": "This status is assigned to a product listing when it has no exemptions from the listed enforcement actions. When the status is `NOT_EXEMPT`, it signifies that Amazon has already taken the specified enforcement actions. There is no exemption in place, and the listed actions are actively enforced"
            }
          ],
          "type": "string"
        },
        "expiryDate": {
          "description": "Represents the timestamp, in ISO 8601 format, that specifies the date when the temporary exemptions expires, and Amazon begins enforcing the listed actions.",
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "status"
      ]
    },
    "ItemIdentifiers": {
      "description": "Identity attributes associated with the item in the Amazon catalog, such as the ASIN.",
      "items": {
        "$ref": "#/$defs/ItemIdentifiersByMarketplace"
      },
      "type": "array"
    },
    "ItemIdentifiersByMarketplace": {
      "description": "Identity attributes associated with the item in the Amazon catalog for the indicated Amazon store.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon store identifier. Identifies the listings item's Amazon store.",
          "type": "string"
        },
        "asin": {
          "description": "The ASIN of the listings item.",
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}