Listings Items

Create or update listing from ASIN

Create or update a listing by copying product data from an existing ASIN and adding offer details. Amazon seller account integration is required to make this request. You can do it here.

put/api/v1/listings/items/{sku}

Request

  • Base URL: https://app.sellerassistant.app (the document declares no server; this is the origin it was published from)
  • URL: https://app.sellerassistant.app/api/v1/listings/items/{sku}
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-Api-Key

Path parameters

Your unique SKU for this listing

Query parameters

Enables validation-only mode without creating/updating listings. Use VALIDATION_PREVIEW to check for errors before actual submission. When enabled, the system validates the request payload and returns validation results without making any changes to your listings.

A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: en_US, fr_CA, fr_FR. Localized messages default to en_US when a localization is not available in the specified locale.

Amazon marketplace domain. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. Options: amazon.com, amazon.ca, amazon.co.uk, amazon.de, amazon.es, amazon.it, amazon.fr, amazon.in, amazon.com.mx, amazon.com.br.

Amazon marketplace id. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. See all options here.

Request body

asinstring required

Existing ASIN associated with product. Must be not parent ASIN.

pricenumber float required

Selling price

currencystring required

Selling price currency

conditionstring required

Identifies the condition of the listings item. Allowed values: new_new, new_open_box, new_oem, refurbished_refurbished, used_like_new, used_very_good, used_good, used_acceptable, collectible_like_new, collectible_very_good, collectible_good, collectible_acceptable, club_club.

isBatteriesRequiredboolean

Indicates if batteries are required for the product. If not provided, defaults to false.

dangerousGoodsRegulationstring

Regulation for dangerous/hazardous goods. Allowed values: ghs, not_applicable, other, storage, transportation, unknown, waste.

isFBAboolean

Is FBA? If yes, fulfillmentChannel attribute will be added with correct value based on marketplace.

attributeOverridesobject

Additional attributes to override. See SP-API Product Type Definitions (https://developer-docs.amazon.com/sp-api/docs/product-type-definitions-api) to get required and optional properties with format schema.

Example request

{
  "asin": "B00U26V4VQ",
  "price": 40.33,
  "currency": "USD",
  "condition": "new_new",
  "dangerousGoodsRegulation": "not_applicable",
  "isFBA": true,
  "attributeOverrides": {
    "max_order_quantity": [
      {
        "value": 3,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ]
  }
}

Response

Successful response

skustring

A selling partner provided identifier for an Amazon listing.

status'ACCEPTED' | 'INVALID' | 'VALID'

The status of the listings item submission. ACCEPTED: The listings submission was accepted for processing. INVALID: The listings submission was not valid and was not accepted for processing. VALID: The listings submission was valid. Only returned when the mode is VALIDATION_PREVIEW.

submissionIdstring

The unique identifier of the listings item submission

Example response

{
  "sku": "Test Catan 07-11-2025 B00U26V4VQ",
  "status": "INVALID",
  "submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003",
  "issues": [
    {
      "code": "90220",
      "message": "'size' is required but not supplied.",
      "severity": "ERROR",
      "attributeNames": [
        "size"
      ],
      "identifiers": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "asin": "B00U26V4VQ"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.