Skip to main content

List Listings Mapped to Configured Products

GET 

/api/configurable-products/mismapped-listings

List channel listings that are already mapped to a configured product — a product that a configured SKU on the same channel resolves to, or whose SKU is one of that channel's configured SKUs. Plain sales of these variants (lines without a SKU option) land on the configured product; re-map each to its base product with Re-map Listing to Base Product.

Required scope: products:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token (scope products:read).

Only unarchived listings on channels that have configured SKUs are checked, newest listing first.

Pagination: page, per_page (default 10, max 100). The response is a standard paginated list: data plus current_page, last_page, per_page, total, from, to, links and the page URLs.

Each row:

  • integration_instance_id — the sales channel connection the listing belongs to.
  • sales_channel_id — the sales channel.
  • channel_type — the channel, e.g. shopify.
  • source_type / source_id — the type of the channel's own product record (e.g. shopify_product) and its ID (for Shopify, the product ID used by the Shopify products endpoints).
  • warning — the warning object (see below). suggested_base_product is null when the listing's history doesn't point to one base product.

Warning object (code is always mapped_to_configured_product):

  • listing_id — the listing's ID, or null for a variant that has no listing yet.
  • listing_sku — the listing's own SKU on the channel.
  • sales_channel_listing_id — the listing's ID on the channel (for Shopify, the variant ID).
  • product — {id, sku, name} of the configured product the listing is (or would be) mapped to.
  • configured_skus — the configured SKUs on this channel that resolve to that product.
  • sold_configured_count — how many distinct configured SKUs this listing has been sold as.
  • suggested_base_product — {id, sku, name} of the likely base product, from this listing's own history: the base product of the configured SKUs sold as this listing when they all agree on one, else the product whose SKU equals the listing's SKU (also the tie-breaker when that history names several bases). Null when the evidence is missing or ambiguous; pick the base product yourself then.
  • message — a sentence explaining the risk, ready to show to a person.

Returns 404 while line options are switched off.

Request​

Responses​

OK

Response Headers
    Content-Type