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.
products:readGrant 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_productis 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
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.